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Documentation Conventions 


Conventions used in directive syntax, messages, and examples throughout the 
MPX-32 documentation set are described below. 

Messages and Examples 

Text shown in this distinctive font indicates an actual representation of a 
system message or an example of actual input and output. For example, 

VOLUME MOUNT SUCCESSFUL 

or 

TSM>! ACTIVATE MYTASK 
TSM> 

Lowercase Italic Letters 

In directive syntax, lowercase italic letters identify a generic element that must be 
replaced with a value. For example, 

$NOTE message 

means replace message with the desired message. For example, 

$NOTE 10/12/89 REV 3 

In system messages, lowercase italic letters identify a variable element. For example, 
* *BRE AK* * ON : taskname 

means a break occurred on the specified task. 

Uppercase Letters 

In directive syntax, uppercase letters specify the input required to execute that 
directive. Uppercase bold letters indicate the minimum that must be entered. For 
example, 

$ASSIGN Ifc TO resource 

means enter $AS or $ASSIGN followed by a logical file code, followed by TO and a 
resource specification. For example, 

$AS OUT TO OUTFILE 

In messages, uppercase letters specify status or information. For example, 

TERMDEF HAS NOT BEEN INSTALLED 
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Brackets [ ] 

An element inside brackets is optional. For example, 

$CALL pathname [ arg] 
means supplying an argument (arg) is optional. 

Multiple items listed within brackets means enter one of the options or none at all. 
The choices are separated by a vertical line. For example, 

$SHOW [CPUTIME | JOBS | USERS] 

means specify one of the listed parameters, or none of them to invoke the default. 

Items in brackets within encompassing brackets or braces can be specified only when 
the other item is specified. For example, 

backspace File [[FILes=] eofs] 

indicates if eofs is supplied as a parameter, FIL= or FILES= can precede the value 
specified. 

Commas within brackets are required only if the bracketed element is specified. For 
example, 

LIST [taskname][, [ownername] [.pseudonym]] 

indicates that the first comma is required only if ownername and/or pseudonym is 
specified. The second comma is required only if pseudonym is specified. 

Braces { } 

Elements listed inside braces specify a required choice. Choices are separated by a 
vertical line. Enter one of the arguments from the specified group. For example, 

[BLOCKED={Y | N}] 

means Y or N must be supplied when specifying the BLOCKED option. 

Horizontal Ellipsis ... 

The horizontal ellipsis indicates the previous element can be repeated. For example, 
$DEFM [par ] [.par] ... 

means one or more parameters (par ) separated by commas can be entered. 
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Vertical Ellipsis 

The vertical ellipsis indicates directives, parameters, or instructions have been omitted. 
For example, 

$DEFM SI, ASSEMBLE, NEW, OP 


$IFA %OP ASSM 

means one or more directives have been omitted between the SDEFM and $IFA 
directives. 

Parentheses ( ) 

In directive syntax, parentheses must be entered as shown. For example, 

{value) 

means enter the proper value enclosed in parentheses; for example, (234). 

Special Key Designations 

The following are used throughout the documentation to designate special keys: 

<ctrl> control key 

<ret> or <CR> carriage retum/enter key 

<tab> tab key 

<break> break key 

<bck> backspace key 

<del> delete key 

When the <ctrl> key designation is used with another key, press and hold the control 
key, then press the other key. For example, 

<ctrl>C 

means press and hold the control key, then press the C. 

Change Bars 

Change bars are vertical lines ( | ) appearing in the right-hand margin of the page for 
your convenience in identifying the changes made in MPX-32 Revision 3.5. 

When an entire chapter has been changed or added, change bars appear at the chapter 
title only. When text within figures has changed, change bars appear only at the top 
and bottom of the figure box. 
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1 Building and Maintaining the System 


1.1 Introduction 

MPX-32 uses system utilities such as the Volume Manager and Text Editor to provide 
mechanisms for building and maintaining resident operating systems. A resident 
system is configured by running the System Generator utility, SYSGEN. A tailored 
system is configured by modifying the Master System Distribution Tape (SDT) and 
SYSGEN file before installation. A System Debugger is supplied that can debug a 
resident operating system or resident user-developed interrupt and device handlers. 

This volume provides documentation on installation from a System Distribution Tape 
(SDT) and Utility Tape, SYSGEN, online and IOP console restart capability, the 
System Debugger, the System Patch facility, System Administrator Services, the 
Device Initializer/Loader, the Alterable Control Store Load and Display utility, the 
Volume Formatter, and Volume Compress. 

The MPX-32 operating system supports floppy disk usage. All references to the 
System Distribution Tape (SDT) apply whether the distribution medium is magnetic 
tape or floppy disk. 

Figure 1-1 provides an overview of installation and configuration as described in 
Chapters 2 through 4 of this volume. 
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Figure 1-1 

MPX-32 Installation/Configuration Overview 
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2 Installing a Starter System 


2.1 Introduction 

Starter systems are supplied on the Master System Distribution Tape (SDT). This 
chapter describes the minimum hardware configuration supported by the starter system 
and the format of the Master SDT. It also includes an example of booting the starter 
system. 

2.2 Hardware Configuration 

The following hardware and logical addresses are used for installing the starter system 
on a CONCEPT/32 computer: 


Software 


Hardware 

Channel Subaddress 


128KW Memory 


XIO magnetic tape 

xxxx 

XX 

XX 

MFP SCSI tape 

7E40 

7E 

40 

MFP/IOP console -or- 

7EFC 

7E 

FC 

CONCEPT 32/2000 
on-board CPU console 

02FC 

02 

FC 

MFP/IOP line printer 

7EF8 

IE 

F8 

Disk drive (XIO) 

xxxx 

XX 

XX 


(Class F) 

User-definable addresses are indicated by x. 

Only the system console is configured in the starter system. User terminals are 
configured by the SYSGEN utility. Once terminals have been configured, they can be 
initialized by the system module J.TINIT. If a terminal initialization file called 
LOGONFLE has not yet been created, all terminals are marked online, but noted as 
failed devices (dead terminals). Before LOGONFLE is created, all terminals have the 
following defaults: 

Wakeup Character - ? 

Baud Rate - 9600 

Parity - EVEN 

Character Size - 7 

ALIM Only - HALF DUPLEX 

For details on creating a LOGONFLE file, see Chapter 10 of this volume. 
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Hardware Configuration 


The following disks are supported by MPX-32 and can be used when booting from 
the Master SDT: 


Disk 

80MB moving head disk - UDP/DPII 
160MB moving head disk - UDP/DPII 
300MB moving head disk - UDP/DPII 
340MB moving head disk - UDP/DPII 
600MB moving head disk - UDP/DPII 
80MB cartridge module disk - HSDP 
337MB moving head disk - HSDP 
474MB moving head disk - HSDP 
500MB moving head disk - HSDP 
689MB moving head disk - HSDP 
800MB moving head disk - HSDP 
850MB moving head disk - HSDP 
858MB moving head disk - HSDP 
1230MB moving head disk - HSDP 
150MB moving head disk - SCSI 
300MB moving head disk - SCSI 
700MB moving head disk - SCSI 
Any other non-floppy disk 

* Disk code applies to both IOP disks 


SYSGEN 
Type Code 

J.VFMT Disk 
Parameter 
Type Code 

MH080 

DC0080 

MH160 

DC0160 

MH300 

DC0300 

MH340 

DC0340 

MH600 

DC0600 

ANY 

DP0080 

ANY 

DP0337 

ANY 

DP0474 

ANY 

DP0500 

ANY 

DP0689 

ANY 

DP0800 

ANY 

DP0850 

ANY 

DP0858 

ANY 

DP01230 

ANY 

SD0150 

ANY 

SD0300 

ANY 

SD0700 

ANY 

NOT AVAILABLE 


and disk processors. 


If a disk code is specified and a mismatch with the drive occurs, an error results. If 
disk code ANY is specified with a nonfloppy disk, a mismatch error cannot occur 
since the relevant operating system table entries are modified to reflect the drive. 


2.3 The Master System Distribution Tape (SDT) 

The system initialization (SYSINIT) process (see section 2.6, System Builder) 
distinguishes between a Master and user SDT by the system name stored in the 
communications region of the MPX-32 operating system (C.SYSTEM). Therefore, 
the following file names are reserved for the system: MSTRALL; MSTREXT; and 
MSTROUT. 

When MSTRALL, MSTREXT, or MSTROUT is detected by SYSINIT, the 
processing of the system images for a master SDT boot is performed. Therefore, 
these files should not be modified. 

Following the system images are a group of saved files. These files include all 
essential load modules to support a fully operational MPX-32 system. Also included 
are the object files required to SYSGEN an MPX-32 system tailored to individual 
hardware and software requirements. 

Figure 2-1 shows the format of the Master SDT. Table 2-1 lists the software included 
on the Master SDT. 
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Table 2-1 

Deliverable Software for MPX-32 


Operating System Modules 

The following modules are memory resident: 


Source 
File Name 

Object 
File Name 

Program 

Name 

Description 

SH.ACBA 

OH.ACBA 

H.ACBA 

Vector Processor SVC 

SH.ADA 

OH.ADA* 

H.ADA 

Aplex ADA Support 

SH.ALOC 

OH.ALOC* 

H.ALOC 

Resource Allocation (Compatible 
Interface) 

SH.BKDM 

OH.BKDM* 

H.BKDM 

Blocked Data Management Module 

SH.DBUG1 

OH.DBUG1* 

H.DBUG1 

Mapped Portion of System 
Debugger(for resident O.S.) 

SH.DBUG2 

OH.DBUG2* 

H.DBUG2 

Unmapped portion of System Debugger 
(for resident O.S.)t 

SH.DMPMT 

OH.DMPMT* 

H.DMPMT 

Stand-alone Dump Writer 

SH.EXEC 

OH.EXEC* 

H.EXEC 

Executive (CPU & IPU Support) 

SH.EXEC2 

OH.EXEC2* 

H.EXEC2 

Optional Executive (CPU & IPU 
DELTA Support) 

SH.EXEC3 

OH.EXEC3* 

H.EXEC3 

Optional Executive (CPU Only) 

SH.EXSUB 

OH.EXSUB* 

H.EXSUB 

Common Executive Subroutines 

SH.FISE 

OH.FTSE* 

H.FISE 

File System (Compatible Interface) 

SH.IOCS 

OH.IOCS* 

H.IOCS 

Input/Output Control System 

SH.MDT 

OH.MDT* 

H.MDT 

Rapid File Access Module 

SH.MEMM 

OH.MEMM* 

H.MEMM 

Memory Management Module 

SH.MEMM2 

OH.MEMM2* 

H.MEMM2 

Optional Memory Management Module 

SH.MONS 

OH.MONS* 

H.MONS 

Monitor Services (Compatible 
Interface) 

SH.MVMT 

OH.MVMT* 

H.MVMT 

Multivolume Magnetic Tape 
Management 

SH.PET 

OH.PET** 

H.PET 

Performance Evaluation Module 

SH.PTRAC 

OH.PTRAC* 

H.PTRAC 

PTRACE Module 

SH.REMM 

OH.REMM* 

H.REMM 

Resource Management Module 

SH.REXS 

OH.REXS* 

H.REXS 

Resident Executive Services 

SH.SINIT 

OH.SINIT* 

H.SINIT 

System Initializer 

SH.SURE 

OH. SURE* 

H.SURE 

High Performance Suspend/Resume 
Module 

SH.SWAPR 

OH.SWAPR* 

H.SWAPR 

Swapper (Resident) 

SH.TAMM 

OH.TAMM* 

H.TAMM 

Task Management Module 

SH.TDEF 

OH.TDEF 

H.DEF 

Terminal Definition Module 

SH.TSM 

OH.TSM* 

H.TSM 

Terminal Service Manager 

SH.VOMM 

OH.VOMM* 

H.VOMM 

Volume Management Module 


t Remains physically memory resident but is not included in logical address space as part of 
the system map. 

* These modules reside in directory OBJECT__OUT as well as OBJECT on the Master SDT. 
** This module resides in directory PET on the Master SDT. 
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The Master System Distribution Tape (SDT) 


Extended Operating System Modules 

The following modules are Extended MPX-32 modules located in directory OBJECTJE. 


OH.ALOC 

OH. EXSUB 

OH.FISE 

OH.MEMM 

OH.MONS 

OH.PTRAC 

OH.REMM 

OH.REXS 

OH.TAMM 

OH.TSM 

OH.VOMM 


Extended H.ALOC 
Extended H.EXSUB 
Extended H.FTSE 
Extended H.MEMM 
Extended H.MONS 
Extended H.PTRAC 
Extended H.REMM 
Extended H.REXS 
Extended H.TAMM 
Extended H.TSM 
Extended H.VOMM 


Interrupt and Trap Handlers 


The following routines are memory resident: 

Source 

Object 

Program 

File Name 

File Name 

Name 

SH.CALM 

OH.CALM* 

H.CALM 

SH.CPU 

OH. CPU* 

H.CPU 

SH.CPU2 

OH.CPU2* 

H.CPU2 

SH.ICP 

OH.ICP* 

H.ICP 

SH.IPOO 

OH.IPOO* 

H.IPOO 

SH.IP02 

OH.IP02* 

H.IP02 

SH.IP03 

OH.IP03* 

H.IP03 

SH.IP04 

OH.IP04* 

H.IP04 

SH.IP05 

OH.IP05* 

H.IP05 

SH.IP06 

OH.IP06* 

H.IP06 

SH.IP07 

OH.IP07* 

H.IP07 

SH.IP08 

OH.IP08* 

H.IP08 

SH.IP09 

OH.IP09* 

H.IP09 

SH.IP0C 

OH.IPOC* 

H.IPOC 

SH.IP0F 

OH.IPOF* 

H.IPOF 

SH.IP10 

OH.IP10* 

H.IP10 

SH.IP13 

OH.IP13* 

H.IP13 

SH.IPAS 

OH.IPAS* 

H.IPAS 

SH.IPCL 

OH.IPCL* 

H.IPCL 

SH.IPHT 

OH.IPHT* 

H.IPHT 

SH.IPIT 

OH.IPIT* 

H.IPIT 

SH.IPPF 

OH.IPPF* 

H.IPPF 

SH.IPU 

OH.IPU* 

H.IPU 

SH.IPUAS 

OH.IPUAS* 

H.IPUAS 

SH.IPUIT 

OH.IPUIT* 

H.IPU1T 

SH.IPVP 

OH.IPVP* 

H.IPVP 


Description 

Optional Calm Replacement SVC Trap Processor 
IPU to CPU Trap Processor (IPU 
Task Scheduler) 

Optional IPU to CPU Trap Processor 
(IPU Task Scheduler) 

Indirectly Connected Interrupt Program 

Power Fail Trap Processor 

Memory Parity Trap Processor 

Nonpresent Memory Trap Processor 

Undefined Instruction Trap Processor 

Privilege Violation Trap Processor 

SVC Trap Processor 

Machine Check Trap Processor 

System Check Trap Processor 

MAP Fault Trap Processor 

Address Specification Trap Processor (32/87, 32/97) 

Arithmetic Exception Trap Processor 

Cache Memory Parity Error Trap Processor 

Attention Interrupt Processor 

System Auto-start Trap Processor 

Real-time Clock Interrupt Processor 

CPU Halt Trap Handler 

Interval Timer Interrupt Processor 

Page Fault Trap Processor 

IPU Executive Trap Processor 

IPU Power Up Auto Start Trap Processor 

IPU Accounting Interval Timer Processor 

Vector Processor Interrupt Handler 


* These modules reside in directory OB JECT_OUT as well as OBJECT on the Master SDT. 
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Device Handlers 


The following handlers are memory resident: 


Source 

Object 

Load 


File Name 

File Name 

Module 

Description 

SH.ASMP 

OH.ASMP 

H.ASMP 

ALIM (ASYNC) - GPMC 

SH.BSMP 

OH.BSMP 

H.BSMP 

BLIM (BISYNC) - GPMC 

SH.CPMP 

OH.CPMP 

H.CPMP 

Card Reader/Punch - GPMC 

SH.CTXIO 

OH.CTXIO* 

H.CTXIO 

IOP Console Terminal 

SH.DCSQ 

OH.DCSCI* 

H.DCSCI 

MFP Disk Handler 

SH.DCXIO 

OH.DCXIO* 

H.DCXIO 

XIO Disk Handler 

SH.DPXIO 

OH.DPXIO* 

H.DPXIO 

HSDP Disk Handler 

SH.F8XIO 

OH.F8XIO* 

H.F8XIO 

IOP 8-Line ASYNC (Full duplex support) 

SH.GPMCS 

OH.GPMCS 

H.GPMCS 

GPMC Subroutines 

SH.HSDG 

OH.HSDG* 

H.HSDG 

Generic High Speed Data (HSD) 

SH.IBLG 

OH.IBLG* 

H.IBLG 

Inter-Bus Link Handler 

SH.IFXIO 

OH.IFXIO* 

H.IFXIO 

XIO Channel Interrupt Fielder 

SH.LPXIO 

OH.LPXIO* 

H.LPXIO 

XIO Line Printer 

SH.MDXIO 

OH.MDXIO* 

H.MDXIO 

XIO Memory Disk 

SH.MTSCI 

OH.MTSCI* 

H.MTSCI 

MFP Tape Handler 

SH.MTXIO 

OH.MTXIO* 

H.MTXIO 

XIO Magnetic Tape 

SH.MUXO 

OH.MUXO 

H.MUXO 

GPMC Multiplexer 

SH.NUXIO 

OH.NUXIO* 

H.NUXIO 

XIO Null Device 

SH.SLMP 

OH.SLMP 

H.SLMP 

SLIM (Synchronous) - GPMC 

SH.XIOS 

OH.XIOS* 

H.XIOS 

XIO Common Subroutines 

* These modules reside in directory OBJECT_OUT as well as OBJECT on the Master SDT. 

Nonresident Routines 



Source 

Object 

Load 


File Name 

File Name 

Module 

Description 

SJ.ACCNT 

OJ.ACCNT 

J.ACCNT 

Accounting Utility 

SJ.ADMNT 

OJ.ADMNT 

ADMOUNT 

Dismount ANSI Labeled Tape Utility 

SJ. AMOUNT 

OJ.AMOUNT 

AMOUNT 

Mount ANSI Labeled Tape Utility 

SJ.ASTAT 

OJ.ASTAT 

ASTAT 

Display ANSI Labeled Tape Utility 

SJ.ATAPE 

OJ.ATAPE 

J.ATAPE 

ANSI Labeled Tape Processing Task 

SJ.AUTO 

OJ.AUTO 

N/A 

Auto Disk Geometry Subroutine 

SJ.AVOL1 

OJ.AVOL1 

AVOLM 

Log ANSI Labeled Tape Utility 

SJ.AVOL2 

OJ.AVOL2 

AVOLM 

Log ANSI Labeled Tape Utility 

SJ.COMP1 

OJ.COMP1 

COMPRESS 

Object Module Concatenation Utility 

SJ. CRYPT 

OJ.CRYPT 

N/A 

ANSI Data Encryption Routine 

SJ.DECMP 

OJ.DECMP 

N/A 

Compressed File Read Subroutine 
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Nonresident Routines (Cont.) 



Source 

Object 

Load 


File Name 

File Name 

Module 

Description 

SJ.DEVL 

OJ.DEVL 

DEVINITL 

Write Control Storage (WCS) 
Initializer 

SJ.DSCMP 

OJ.DSCMP 

J.DSCMP 

Disk Compress Module 

SJ.DTSAVE 

OJ.DTSAVE 

J.DTSAVE 

Auto Date and Time Update for 
Mounted Volumes 

SJ.ENABLE 

OJ.ENABLE 

ENABLE 

Terminal Online Task (SA only) 

SJ.ERR 

OJ.ERR 

M.ERR 

MPX-32 Abort Code Module 

SJ.xx.ER 

N/A 

N/A 

Sample Source for Error File 

SJ.FORMF 

OJ.FORMF 

J.FORMF 

Format Floppy Formatter Program 

SJ.FREAD 

OJ.FREAD 

N/A 

Read Subroutine for Key and 
Project 

SJ.HELP 

OJ.HELP 

HELP 

Help Service 

SJ.HELPT 

OJ.HELPT 

HELPT 

Help Translator 

SJ.HLP 

OJ.HLP 

J.HLP 

Help Load Module 

SJ.INIT 

OJ.INIT 

J.INIT 

System Initializer 

SJ.KEY 

OJ.KEY 

KEY 

M.KEY File Editor 

SJ.KEYWD 

OJ.KEYWD 

KEYWORD 

User Key Task 

SJ.LABEL 

OJ.LABEL 

J.LABEL 

Label ANSI Tape Utility 

SJ.LIST 

OJ.LIST 

LIST 

List File Utility 

SJ.LOGCNT 

OJ.LOGCNT 

LOGCNT 

Terminal Logon Counter Task 

SJ. LOGTIME 

OJ.LOGTIME 

LOGTIME 

Terminal Logon Timer Task 

SJ. MEREST 

OJ.MDREST 

J.MDREST 

Memory Disk Restore Task 

SJ.MDSAVE 

OJ.MDSAVE 

J.MDSAVE 

Memory Disk Save Task 

SJ.MDTI 

OJ.MDTI 

J.MDTI 

MDT Initialization Task 

SJ.MOUNT 

OJ. MOUNT 

J.MOUNT 

System Mount Service 

SJ.OPCOM 

OJ.OPCOM 

OPCOM 

Operator Communications 

SJ.PAUSE 

OJ.PAUSE 

PAUSE 

Pause Task 

SJ.PROJ 

OJ.PROJ 

J.PRJCT 

Project Accounting Utility 

SJ.PSWD 

OJ.PSWD 

PASSWORD 

User Password Task 

SJ.REST 

OJ.REST 

RESTART 

On-line Restart 

SJ.SHAD 

OJ.SHAD 

J.SHAD 

Shadow Memory RRS Utility 

SJ.SOEX 

OJ.SOEX 

J.SOEX 

Output Spooling Executive 

SJ.SOUT 

OJ.SOUT 

J.SOUT 

Output Spooler 

SJ.SSIN 

OJ.SSIN 

J.SSIN1 

Input Spooling - Files 

SJ.SSIN 

OJ.SSIN 

J.SSIN2 

Input Spooling - Devices 

SJ.SWAPR1 

OJ.SWAPR1 

J.SWAPR 

Nonresident Swapper (code) 

SJ.SWAPR2 

OJ.SWAPR2 

J.SWAPR 

Nonresident Swapper (parameters) 

SJ.TDEFI 

OJ.TDEFI 

J.TDEFI 

Terminal Definition 
Initialization Task 

SJ.TERMOUT 

OJ.TERMOUT 

TERMOUT 

Terminal Session Timer Task 


v 
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Nonresident Routines (Cont.) 


Source 
File Name 

Object 
File Name 

Load 

Module 

Description 

SJ.TINIT 

OJ.TINIT 

J.TINIT 

Terminal Initializer 

SJ.TSET 

OJ.TSET 

J.TSET 

Set Terminal Type Utility 

SJ.TSM 

OJ.TSM 

J.TSM 

Terminal Service Monitor 

SJ.UNLCK 

OJ.UNLCK 

J. UNLOCK 

Dual Port Unlock Utility 

SJ.UFDPT 

OJ.UPDPT 

N/A 

Volume Formatter Disk Parameter Table 

SJ.VFMT 

OJ.VFMT 

J.VFMT 

Volume Formatter 

SJ.VPRE 

N/A 

N/A 

Volume Formatter and Volume 
Manager PRE File 

SORT.MERGE 

OJ.SORT.MERGE 

FSORT2 

Sort/Merge * 

FUP** 

N/A** 

VOLMGR 

Volume Manager ** 


* Directory SORT.MERGE contains the source file, SOR.SRC, used to create the object 
used to build the sort/merge library and FSORT2. 

** Directory FUP contains all source files used to create the object library FUP.LIB and 
object directory FUP.DIR. These are used for building VOLMGR. 


SYSGEN 



The following are SYSGEN load 

Source 

Object 

File Name 

File Name 

SJ.FMTIO 

OJ.FMTIO 

SJ.OBUTL 

OJ.OBUTL 

SJ.PSCAN 

OJ.PSCAN 

SJ.SDBUG 

OJ.SDBUG 

SJ.SEXEC 

OJ.SEXEC 

SJ.SGINI 

OJ.SGINI 

SJ.SPH01 

OJ.SPHOl 

SJ.SPH02 

OJ.SPH02 

SJ.SPH03 

OJ.SPH03 

SJ.SPH04 

OJ.SPH04 

SJ.SSCAN 

OJ.SSCAN 

SJ.STACK 

OJ. STACK 

SJ.STBLS 

OJ.STBLS 


module components: 

Description 

SYSGEN Formatter 
Object Processor 
SYSGEN Scanner 
SYSGEN Debugger 
Executive (Root Segment) 
Initialization Overlay 
Phase 1 
Phase 2 
Phase 3 
Phase 4 

Keyword Scanner 
SYSGEN Stack 
Device Type Table 
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The following are SYSGEN files: 


File Name 


Description 


MSTRALL 

MSTRALLS 

MSTRALLD 

MSTREXT 

MSTREXTS 

MSTREXTD 

MSTROUT 

MSTROUTS 

MSTROUTD 

OH.32 

OH.32_E 

OH.32_OUT 

SG.32 

JH.32 

JH.32_E 

JH.32_OUT 


System Image File for all CONCEPT 32/xc machines 

System Symbol Table File for all CONCEPT 32/xx machines 

Directive File for all CONCEPT 32/xx machines 

System Image File for extended-mode image 

System Symbol Table File for extended-mode image 

Directive File for extended-mode image 

Mapped Out System Image File for CONCEPT 32/2000 

Mapped Out System Symbol Table File for CONCEPT 32/2000 

Mapped Out Directive File for 32/2000 

Compressed System Object 

Extended Compressed System Object 

Mapped Out Compressed System Object 

Sample SYSGEN Macro/Directives 

COMPRESS Input Directives 

Extended COMPRESS Input Directives 

Mapped Out COMPRESS Input Directives 



Miscellaneous 


The following are Help text files: 


File Name Description 


DS.HLP 

GMPX.HLP 

PROC.HLP 

SAT.HLP 

SVC.HLP 

TOP.HLP 


Data Structures 
General MPX Help 
Processors 

System Administrator Tools 
SVC Calls 
Top Level Menu 





The following are macro library files: 


File Name 


Description 


M.EQUATESX32 

M.MACLIB 

M.MPXMAC 

M.OSEQUATESX32 

M.SERVICESX32 

SM.EQUATESX32 

SM.MPXMC 

SM.OSEQUATESX32 

SM.RTMMC 

SM.SERVICESX32 


X32 Macros for user data structures 

MPX/RTM Macro Library 

MPX-32 Macro Library 

X32 macros for system data structures 

X32 macros for system services 

Source used to load M.EQUATESX32 

Source used to load M.MPXMAC (MPX-32 macros) 

Source used to load M.OSEQUATESX32 

Source used to load M.MACLIB (RTM compatible macro library) 
Source used to load M.SERVICESX32 



2-8 


Installing a Starter System 



The Master System Distribution Tape (SDT) 


The following are subroutine library files. 


File Name Description 


MPXDIR 

MPXLIB 

FUP.DIR 

FUP.LIB 

SORT.DIR 

SORT.LIB 


MPX-32 System Subroutine Directory (null) 

MPX-32 System Subroutine Library (null) 

File Utility Program (VOLMGR) Subroutine Directory 
File Utility Program Library 
Sort/Merge Directory 
Sort/Merge Library 


The following are PRE files: 


File Name Description 


MPX_EXT 

MPX_NON 

MPX_OUT 

MPXPRE 


PRE File for assembly of Extended MPX-32 modules 

PRE File for assembly of Nonextended MPX-32 modules 

PRE File for assembly of mapped out modules (CONCEPT 32/2000 only) 

Default PRE File for macro assembler 


The following are Job Control Language (JCL) files: 


File Name Description 


JJ.A.HLP 

JJ.A.NON 

JJ.A.ONE 

JJ.A.RS1 

JJ.A.RS2 

JJ.A.RS3 

JJ.A.SGN 

JJ.A.SWP 

JJ.A.TDI 

JJ.A.VOL 

JJ.B.LIB 

JJ.B.MAC 

JJ.C.VOL 

JJ.COMPR 

JJ.ID 

JJ.M.ERR 

JJ.MSTR 

JJ.SORT 

JJ.XX.ER 

BATCH.OS 

MSTRSDT 

MSTRSRCE 


JCL to assemble/catalog online help modules 

JCL to assemble/catalog nonresident modules 

JCL to assemble a component of VOLMGR 

JCL to assemble resident modules (Services/Processors) 

JCL to assemble resident modules (Interrupts/Traps) 

JCL to assemble resident modules (Device Handlers) 

JCL to assemble/catalog SYSGEN 

JCL to create swapper load module (J.SWAPR) 

JCL to assemble/catalog J.TDEFI 

JCL to batch all assemblies for components of VOLMGR 

JCL to create/build the null MPXLIB/MPXDIR 

JCL to create/build macro libraries M.MPXMAC,M.MACLIB 

JCL to build VOLMGR 

JCL to create/load COMPRESSed files Object Module 

JCL to run SEARCHER to create MPX-32 ID (time/date and program ED 

information) 

JCL to assemble/catalog M.ERR (MPX-32 Revision 3 jc Aborts) 

JCL to create Master System Images 

JCL to build Sort/Merge 

JCL to assemble/catalog SJ.xv.ER (User Aborts) 

JCL for building MPX-32 Rev. 3 by processing JCL files 

JCL to build the Master SDT 

JCL to build the Master Source Tape 
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Support Files 

The following are 

support files: 

File Name 

Description 

LOGONFLE 

Terminal initialization file 

M.CNTRL 

System Control File 

M.KEY 

Key file 

M.PATCH 

Patch file 

MPX.PRO 

Terminal Profile 

MPX.PRO.NOTDEF Terminal Profile when TERMDEF file is not installed 

MPX.PRO.TDEF 

Terminal Profile when TERMDEF file is installed 

TDEFLIST 

List of supported TERMDEF functions 

TERMDEF 

Terminal definition file 

VOLM 

Macro for invoking VOLMGR 

Directories 

FUP 

File Utility Program containing source files for creating libraries 
VOLMGR 

OBJECT 

Object files 

OBJECT_E 

Object modules for extended MPX-32 

OBJECT_OUT 

Object modules for mapped out (CONCEPT 32/2000 only) 

PET 

Performance Evaluation Tool 

SORT. MERGE 

Sort/Merge 


2.3.1 Magnetic Tape 

The format of the magnetic tape Master SDT is similiar to the User SDT. Both 
contain a tape boot loader followed by an MPX-32 image. The master tape, however, 
contains three MPX-32 images instead of one. The three images are: 

• MSTRALL — default image for all CONCEPT 32/jcjc computers 

• MSTREXT — extended-mode image 

• MSTROUT — default image for CONCEPT 32/2000 computers 

When building the Master SDT, the Volume Manager sets a flag enabling the tape 
boot loader to recognize a master boot and skip to the proper image for the 
appropriate CPU. If an image other than the default is desired, it can be selected 
using console panel mode commands. (See section 2.4, Booting a System from the 
Master SDT, in this chapter.) 

2.3.2 Utility Tape 

The utilities are contained on a separate tape, as an unbundled product, as shown in 
Figure 2-1. After the SDT has been restored, restore the desired utilities before exiting 
the Volume Manager. 
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MAGNETIC TAPE 

BOOT LOADER 

MPX - 32 
IMAGE 1 


MPX -32 
IMAGE 2 


MPX -32 
IMAGE 3 


J.VFMT 


J. MOUNT 
J.SWAPR 
VOLMGR 


MASTER SDT 
SAVED FILES 

SEPARATE UTILITY 
TAPE 


DOUBLE EOF REQUIRED BY VOLMGR 


R3020 


Figure 2-1 

Master System Distribution Tape Format 
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2.4 Booting a System from the Master SDT 

Mount the Master SDT on a tape drive and note its address. If the system console is 
connected to an IOP or MFP controller, the controller must be configured to channel 
X’7E\ If the system console is to be connected to the CONCEPT 32/2000 CPU’s 
on-board F-class controller, it is recommended that the controller be configured to 
channel X’02\ 

To boot a CONCEPT/32 computer with the system console connected to an IOP or 
MFP controller, perform the following steps on the system console: 


Enter panel mode by typing: 

@0P 

System response: 

// 

Halt the system by typing: 

//HALT 

System response: 

II 

Reset the system by typing: 

/ /RST 

System response: 

II 

Clear memory by typing: 

//CLE 

System response: 

II 

Skip the next step if you wish to boot 
the default system image. 

Override the default system image by typing: 

//GPR0=« 

System response: 

n = 1 to select MSTRALL 
(non-extended MPX-32) image 

n = 2 to select MSTREXT 
(extended MPX-32) image 

1/ 

Load the system by typing: 

//lPL=address of tape unit 


(Skip the following instructions regarding booting on a windowing console and 
continue booting after the system has been loaded.) 

To boot a CONCEPT 32/2000 computer with the system console connected to the 
F-class I/O channel on the CPU, perform the following steps on the windowing 
console: 

Enter panel mode by activating the Panel Window on the windowing console. 
System Response: The Panel Window drag bars become solid. 

Halt the system, if not already halted, by selecting the halt command from 
the Panel Window menu. 

System Response: The Node Status Window indicates that the CPU is halted. 

Reset the system by selecting the reset command from the Panel Window 
menu. 

System Response: The CPU registers and PSD displayed in the Panel 
Window are cleared. 
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Clear memory by selecting the clear mem command from the Panel 
Window menu. 

System Response: The mouse pointer changes to wait while memory is 
being cleared. 

Override the default system image by changing the contents of GPRO to: 

gprO: 00000001 to select MSTRALL (non-extended MPX-32) 

image. 

gprO: 00000002 to select MSTREXT (extended MPX-32) image. 

Load the system by selecting ipl from the Panel Window menu. 

System Response: A sub-window prompting for the address of the tape unit 
appears. 

Enter the tape unit’s address in the sub- window. 

The boot loader on the Master SDT begins execution. It selects and loads the proper 
system image for the CPU to be used, and passes control to SYSINIT, the system 
initialization program. The following prompts are displayed on the system console: 

» 

This prompt is displayed whenever the system debugger is configured in the 
system image being loaded. The system debugger is configured in all Master 
SDT images. Enter TE to continue normal system operation. When upgrading 
to a new revision of MPX-32, terminal initialization is inhibited at this point 
by responding to the system debugger as follows: 

» CM 780, 10000000 
» TE 

This sets control switch 3. 

BOOT FROM A SCSI TAPE? (REPLY Y OR N) : 

Enter Y if booting from a SCSI tape drive. 

MPX-32 MASTER SDT FOR CONCEPT 32 /n COMPUTERS 

n is 67 for a 32/67, n is 87 for a 32/87, 97 for a 32/97, or 2 000 for a 
32/2000. 

ENTER SYSTEM DEVICE CHANNEL AND SUBADDRESS: 

Enter the channel and subaddress of the desired disk drive (for example, 

0800) as the logical device address where MPX-32 is to be installed. If an 
invalid system device address is entered, the following message appears: 

CANNOT FIND PROPER DISC UDT . . . 

SYSINIT ABORT RECEIVER ENTERED... 

» 
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ENTER DISC CONTROLLER TYPE: XIO (UDP OR DP II), HSDP, OR 
MFP (REPLY X, H, OR M) : 

Enter the appropriate response for this disk prompt. If an incorrect value is 
entered, J.VFMT will detect the error during execution (see below) and abort. 

MEMORY INITIALIZATION STARTED 

MEMORY INITIALIZATION COMPLETE 

ENTER DATE AND TIME: 

Enter the date and time using the following syntax: 
datejih[:\mn[:ss][, [D] [,TZ =num] ] 
date is the current date in one of the following formats: 

m m/dd/yy 

dd-mm-yy 

ddmmmyy 

where mm is the 2-digit decimal month, dd is the 2-digit 
decimal day, yy is the 2-digit decimal year, and mmm is the 
3 -ASCII-character month abbreviation. 

hh is the 2-digit decimal hour (24 hour time) 

mn is the 2-digit decimal minute 

ss is the 2-digit decimal second. If the colon between hh and 

mm is omitted, this parameter is ignored. 

D indicates daylight savings time. Specifying this field causes 

the internally stored binary time to be adjusted by one hour. 

TZ =num allows the internal binary time to be biased by num hours. 

The value of num can be positive or negative. This field 
allows file times to be kept according to a given standard 
while the displayed time (see OPCOM TIME directive) is the 
correct local time. 

Examples: 

06/16/81,08:45:00 

06/09/81,11:20:00 

14- 06-81,13:00:00 
03NOV81, 09:25:00 
08/29/81, 10:33, D 

15- 04-81, 19:15: 00, D,TZ=-3 
05MAY81 , 16:15, ,TZ =10 

TASK LOADING FROM TAPE STARTED 
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FMT> 


This is the Volume Formatter prompt. The Volume Formatter builds the 
on-disk structures required by the MPX-32 file system. 

Important: See Chapter 13 of this volume for more information on the 
Volume Formatter. Many important user-selected parameters are only 
available at this point and cannot be changed later without removal of all user 
data on the disk. 

If you are installing MPX-32 for the first time, and targeting a new disk media 
that has never been media verified, follow step A below. As an alternative to 
step A (INITIALIZE) you may choose to run the Level II Diagnostic Media 
Verification program (HSDP or UDP/DP II controllers) or the Level II 
Diagnostic program (MFP SCSI) before installing the SDT. The instructions 
in step A can also be used to reconfigure structures built by the INITIALIZE 
directive on a currently formatted disk. 

If you are installing MPX-32 for the first time and targeting disk media that 
has been media verified, or if you are upgrading MPX-32, but wish to 
reconfigure currently formatted disk structures built by the FORMAT directive, 
follow step B below. 

If you are only upgrading MPX-32 with a Master SDT tape, follow step C 
below. 

Warning: Selecting steps A or B below will result in the removal of all user 
data on the disk. Be sure all important files have been saved to tape or another 
disk. 

A. The minimum response required at this prompt is: 

FMT> INITIALIZE DEVICE =devmnc DIS C=dcode 

devmnc is a 6-character device mnemonic (2-character device type 
mnemonic, 2-digit hexadecimal channel number, 2-digit 
hexadecimal device subaddress); for example, DM0800 
or DM0402. 

dcode dcode is the disk storage device type code. Refer to Note 
1 in the INITIALIZE directive section of Chapter 13 for a 
list of disk type codes. 

If desired, other INITIALIZE command parameters may also be 
included on the command line. The INCLUDE parameter must not be 
used. If the FMAP parameter is specified, the line printer must be 
online. 

This command causes the hardware -required disk structures (e.g., 
track and sector labels) to be written to the disk. This is in 
preparation for item B below. 

At the completion of the INITIALIZE command, FMT> appears 
again. When this prompt appears, follow step B below. 
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B. The minimum response required at this prompt is: 

FMT> FORMAT DEVICE=*fev/n«c VOLZME=volname 

devmnc is a 6-character device mnemonic (2-character device type 
mnemonic, 2-digit hexadecimal channel number, 2-digit 
hexadecimal device subaddress); for example, DM0800 
or DF0802. 

volname is a 1- to 16-character volume name. Valid characters are 
A through Z, 0 to 9, dot (.) and underscore (_)• 

If desired, other FORMAT command parameters may also be included 
on the command line, for example, ACCESS=, CONFIRM=, 
MAXRES=. The IMAGE parameter must not be used. If the 
BOOTFILE parameter is used, the only acceptable values are OLD 
and NEW. 

This command causes the volume structures required by the MPX-32 
file system to be written to the disk, the selected image on the Master 
SDT to be the default image, and the disk bootstrap to be updated. 

Volume Formatter will exit upon completion of this command. 

C. Enter only the following at the Volume Formatter prompt: 

FMT> REPLACE DEVICE=devmnc VOLXJME=volname 

devmnc is a 6-character device mnemonic (2 -character device type 
mnemonic, 2-digit hexadecimal channel number, 2-digit 
hexadecimal device subaddress); for example, DM0800 
or DM0402. 

volname is a 1- to 16-character volume name. Valid characters are 
A through Z, 0 to 9, dot (.) and underscore (_)• 

This command cause the image on the Master SDT to be the new 
default image and the disk bootstrap to be updated. Volume Formatter 
will exit upon succesfull completion of this command. 

Note: If the Volume Formatter determines that volume structures exist on the 

specified disk device, this interactive prompt is issued: 

DESTROY OPTION NOT ENABLED FOR FORMATTED VOLUME, 
VOLUME NAME ^volname 
CONTINUE - Y/N? 

where volname is the current volume name of the specified disk device. 

Enter Y to continue. If you select N, you must rewind the SDT tape 
and start the boot procedure anew. Entering DESTROY=Y on the 
command line for steps A or B will prevent this prompt from appearing. 
This is not an option for step C. 

For all steps (A, B, or C), if the CONFlRM=N parameter is not entered 
at the command line, an interactive prompt to continue is written to the 
screen. You may make changes in the displayed parameters or enter 
CONFIRM=N to continue. 
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Important: If any error messages are issued by Volume Formatter 
followed by an abort, take corrective action, rewind the SDT tape, and 
start the boot procedure anew. 

J. MOUNT - MOUNTING VOLUME volname ON devnmc 
If volume clean up is required, the following message is issued. 

J. MOUNT - VOLUME CLEAN UP ON volname 

VOL> 

This is the Volume Manager prompt. When installing MPX-32 for the first 
time (e.g. steps A and B or step B above were performed), the system 
directory must be created before files on the SDT can be restored. Only the 
system directory is required. OBJECT, SOURCE, HELP, SORT.MERGE, 
BUILDJCL, FUP, PET, REDUCE, MIPS.SRC, CSWI, INTR, and DEMO are 
optional and do not have to be created by the user. 

The minimum response required at the Volume Manager prompt is: 

VOL> CREATE D SYSTEM ENTRIES=«« 

Note: The number of entries allowed in the SYSTEM directory ( nn above) 

must be greater than 300 to accommodate all system files on the 
Master SDT. 

If desired, other parameters such as OWNER=, PROJECTGROUP=, and 
ACCESS= may also be included with this directive. 

Saved files on the Master SDT can now be restored. Restore the first three 
images using the RESTORE directive. Then exit Volume Manager. 

VOL> RESTORE V0LUME=SY STEM (information files and INSTALLSDT) 

VOL> RESTORE VOLUME=SY STEM (non-resident module) 

VOL> RESTORE VOLUME=SY STEM (non-resident module) 

VOL> EXIT 

A series of messages -- DISC FFFF MARKED OFF LINE — are now 
displayed. 

If J.TINIT is restored from the Master SDT, one of these initialization 
messages is displayed. The one that is displayed depends on whether the 
system file, LOGONFLE, exists or was restored on the currently mounted 
system volume. See Chapter 10 of this volume for details on how to build 
LOGONFLE. 
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INITIALIZATION COMPLETE 
TERMINAL SETUP COMPLETE 

(or) 

INITIALIZATION COMPLETE 

M. ASSN DENIAL, NO LOGON FILE, DEFAULT USED 
TERMINAL SETUP COMPLETE 

PRESS ATTENTION FOR TSM 

Upon entering @@A for attention, a prompt is issued to enter a 1- to 8- 
character logon owner name and a 1- to 8-character logon key. The following 
characters cannot be used in owner names or keys: blanks, commas, 
semicolons, equal signs, line feeds, dollar signs, exclamation points, percent 
signs, and left or right parentheses. After entering a valid owner name and 
key, the TSM prompt is displayed and any valid TSM directive can be entered. 

If a valid M.KEY file does not exist at logon, the following message is 
displayed prior to the TSM> prompt: 

UNABLE TO ESTABLISH A DEFAULT WORKING DIRECTORY 
YOUR CURRENT WORKING DIRECTORY IS 0SYSTEM (SYSTEM) 

Initiate the Master SDT tape installation macro by typing INSTALLSDT. 
TSM> INSTALLSDT 

This macro will restore the other images on the Master SDT. Through a series 
of interactive prompts, the macro allows you to choose which Master SDT 
images to restore, or simply restore all of them. 

WOULD YOU LIKE A HARDCOPY OF THE SDT. CONTENTS FILE 
TO ASSIST YOU IN THIS INSTALLATION ? (Y/N) : 

Enter Y to print a copy of the SDT.CONTENTS file. 

IS THIS A COLD START (Y/N) : 

For a cold start, enter Y. The following prompt will appear: 

ENTER LINE PRINTER DEVICE ADDRESS (LP7EF8) : 

Respond to this prompt by typing the address of the line printer device. 

For a warm start, enter N. 

The next prompt provides the option of restoring the entire Master SDT tape. 

DO YOU WISH TO INSTALL THE ENTIRE TAPE ? (Y/N) 

If you wish to restore every image on the Master SDT (except the first three), 
enter Y and follow step A below. If you wish to restore some images on the 
Master SDT, but not others, enter N and follow step B below. 

A. After Y is entered, the following prompts appear. 

ENTER MAGNETIC TAPE DEVICE ADDRESS (M91000) : 

Enter the address at which the Master SDT is mounted. 
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ENTER THE VOLUME NAME WHICH THE SDT WILL BE 
INSTALLED ON : 

Enter SYSTEM here. 

MOUNT MESSAGES ARE NOW TURNED OFF UNTIL 
INSTALLATION HAS COMPLETED. 

As each image is restored, a message appears stating that the image 
has been restored. After the process of restoring the Master SDT 
images is complete, the following appears: 

THE SDT HAS BEEN INSTALLED ACCORDING TO THE 
INT STRUCT IONS SUPPLIED BY THE USER. 

The INSTALLSDT macro then rewinds the Master SDT tape, issues 
the following message, and exits: 

MOUNT MESSAGES ARE NOW TURNED BACK ON 

B. After N is entered, a series of prompts appears asking which images 
are to be restored. Each prompt lists a group of images and asks if 
these images should be restored. These prompts appear in the order 
shown below, grouping the images as follows: 

• required images (nonresident routines, COMPRESS object, resident 
services and processor objects, resident interrupt and trap objects, 
resident device handler objects, HELP text files, macro libraries, 
PRE files, macros, TERMDEF, and SYSGEN files) 

• extended MPX-32 image 

• mapped-out images 

• sort merge files 

• unsupported load modules and source images 

• patch file image 

• optional files (can be skipped for warm starts) 

• JCL files for building the operating system, source files contained 
on the SDT, and macro library source 

• FUP library, nonresident object, and SYSGEN object 

• Performance Evaluation Toolkit 

• MIPSMON images, M.SURE test suite, and H.ICP test suite 

• MPX-32 Demo images 

If you enter Y in response to a prompt, all of the images listed in 
that prompt will be restored. If you enter N, none within that prompt 
will be restored. 

After these 12 prompts have been responded to, follow step A above, 
begining with the ENTER MAGNETIC TAPE DEVICE ADDRESS 
prompt, to restore all those images responded to with Y. 
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After the INSTALLSDT macro has exited, mount any unbundled software 
tapes on the tape drive and restore them using the Volume Manage RESTORE 
directive. 

Type the following to assign the task to tape: 

TSM> AS TAP TO DEV=M9 BLO=N 

Then type VOLMGR to re-enter Volume Manager. After all desired saved files 
are restored, type EXIT to exit the Volume Manager. 

TSM> VOLMGR 

VOL> RESTORE VOLUME=SYSTEM 


VOL> EXIT 

Note: If the system does not install as described, check the hardware/firmware 

revisions of the system and contact the Encore Field Representative. 
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2.4.1 Control Switches 

While rebooting the system, various initialization processes can be inhibited or 
enabled by setting the appropriate control switches. The assignment of the 13 switches 
is: 

Switch Function if set 

0 inhibits volume clean-up by J.MOUNT 

1 SYSINIT enters the system debugger before processing patches 

2 inhibits patch processing (See Chapter 9, Entry Conditions.) 

3 inhibits terminal initialization 

4 inhibits accounting functions including the M.KEY, M.PRJCT, 

M.ACCNT, and M.ERR files 

5 inhibits processing of the sequential task activation table at 
IPL time 

6 If J.MOUNT encounters an invalid resource descriptor due to an 
invalid resource descriptor type field or space definition, it 
branches and links to the system debugger (if present) with R2 
pointing to the resource descriptor. 

7 J.MOUNT prereads the file space bit map (SMAP) or the resource 
descriptor allocation bit map (DMAP). J.MOUNT will not perform file 
overlap protection. 

8 delete spooled output files instead of resubmitting them for 
processing 

9 inhibits activating LOADACS during IPL or RESTART operations 

10 enables faster memory initialization by checking only one location 
per map block to determine if that map block is present. It is not 
recommended that this switch be set on the first IPL after power up. 

1 1 inhibits initialization of the memory descriptor table (MDT) 

12 for RMSS: inhibits booting of nodes while J.BOOT executes 

The control switches can be accessed by the console. The proper time to set the 
switches is while the system is waiting for the date and time to be entered. To set, for 
example, switch 3, the following must be entered at an MPF or IOP console: 

ENTER DATE AND TIME: 6@P 

//CS=10000000 Terminal Initialization Inhibited 

//@0C 

<CR> 

INVALID DATE FORMAT=MM/DD/XX 
ENTER DATE AND TIME: 

(Refer to the CONCEPT 32/2000 Operation manual for instructions on the windowing 
console.) 

During power up, control switches are prezeroed if the proper firmware revision level 
has been installed. Power up without prezeroing can cause unexpected system 
responses due to incorrect control settings. 
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All control switch settings are preserved during system reboots not involving system 
power up (i.e., online restart and IPL). 

2.5 Philosophy of Bootstrapping 

The SDT process attempts to eliminate as much stand alone I/O from the startup code 
as possible because it is difficult to maintain stand alone capability for a number of 
different types of controllers. This philosophy is reflected in the operation of the 
system initialization program SYSINIT. For further details on SYSINIT, see section 
2.6 of this chapter. 

Because there may be no information on the disk at IPL time, tasks cannot be 
activated from the disk. Therefore, the four needed tasks (Volume Formatter, Mount, 
J.SWAPR, and Volume Manager) are supplied in load module format on the Master 
SDT. SYSINIT performs tape activations on these four load modules to allow the 
System Builder to: 

• format the disk and build a bootable operating system (Volume Formatter) 

• mount the system volume (Mount) 

• activate the swapper (J.SWAPR) 

• restore the files needed from the Master SDT and the Utility tape to make the 
system function (Volume Manager). 
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2.6 The System Builder 

Following the operating system in memory is a two-part module called SYSINIT. 
This module is included by SYSGEN and is responsible for initializing the MPX-32 
environment. 

The first part, Phase I, runs stand alone. That is, MPX-32 is not yet functioning. 
Phase I loads the CPU scratchpad, enables interrupt levels, resets I/O channels, and 
performs any other cleanup operations required. It then sets up Phase II to nm as an 
MPX-32 task. When Phase I enables interrupts, a clock interrupt occurs and causes 
Phase II to begin execution as a task. 

Phase II activates the Volume Formatter, allowing the new volume to be formatted. 
Next, the volume mount service is activated and mounts the system volume. After the 
system volume is mounted, J.SWAPR is activated. Because there may be no 
information on the disk at IPL time, activations are made from the SDT, causing 
backward and forward movement of the tape. After this, the Volume Manager is run. 
This utility restores any files that are required for system operation. These files must 
include all key load modules and may also include any desired files. When Phase II 
completes, the system is fully initialized and must be opened for user access. Phase II 
accomplishes this by activating J.INIT, J.TINIT and J.TSM. 

The user interaction for the above procedure on a Master SDT is described in section 
2.4, Booting a System from the Master SDT. 

The user interaction for the above procedure on a User SDT is described in Chapter 4 
of this volume. 


2.7 Operating Under the Starter System 

The MPX-32 system is both disk and memory resident. TSM can be entered by 
entering 0 0 A then the system owner name and no key. Valid owner names are 
created by the KEY utility. 
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2.8 Restoring Utility Processors, Libraries, and Other Files 

The Volume Formatter (J.VFMT) and Volume Manager (VOLMGR) utilities are 
supplied on the Master SDT. All other utilities such as the Text Editor, Macro 
Assembler, and Media are an unbundled product. After all required files have been 
restored from the Master SDT, all desired unbundled software must be restored. 

Load modules on the tapes are saved by using Volume Manager SAVE directives and 
can be restored from the tapes by using Volume Manager RESTORE directives. Each 
save directive allows up to 48 entries. An end-of-file (EOF) is written after each group 
saved. 

When restoring files, use a restore directive for each group. Initially, all files should be 
restored from the Master SDT and the Utility tape using the Volume Manager 
RESTORE VOLUME directive. In subsequent interactions, selective restore 
capabilities of the Volume Manager can be used for system installation and 
maintenance. 

The number of groups of files saved on the tapes can vary, and an equivalent number 
of restore directives are required to install them. A listing is provided with the Master 
SDT showing the groups in which the files were saved. Before continuing, check the 
listing. Restore all groups of libraries, system files, and utilities (one restore directive 
per group) using the listing as a guide. 
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2.9 Example of First Use of Master SDT on User System 

The following examples show how to boot a starter system from the Master SDT. 
The first illustrates the entire booting process. The next two show the commands 
needed to choose a system image other than the default. 

2.9.1 Using the Default Master SDT Image on a CONCEPT 32/97 


//HALT 
/ /RST 
//CLE 

/ /IPL=1000 

»TE 

BOOT FROM A SCSI TAPE? (REPLY Y OR N) : N 
MPX-32 MASTER SDT FOR CONCEPT 32/97 COMPUTERS 
ENTER SYSTEM DEVICE CHANNEL AND SUBADDRESS: 0800 
ENTER DISC CONTROLLER TYPE: XIO (UDP OR DP II), HSDP, OR MFP 
(REPLY X, H, OR M) : X 

MEMORY INITIALIZATION STARTED 

MEMORY INITIALIZATION COMPLETE 

ENTER DATE AND TIME: 04/23/90,13:30 
TASK LOADING FROM TAPE STARTED 

FMT> FORMAT DEVICE=DM0800 VOLUME=JONES MAXRES=3000- 
FMT CONFIRM=Y 


Enter CONFlRM=N to continue execution, or enter any changes. 

FMT> CONFIRM=N 

DEVICE=DM0 800 — VOLUME FORMATTING SUCCESSFULLY 
COMPLETED 

J. MOUNT - MOUNTING VOLUME JONES ON DM0800 
VOL> CREATE D SYSTEM ENTR=1000 
VOL> RESTORE VOLUME=S YSTEM 
VOL> RESTORE VOLUME=SYSTEM 
VOL> RESTORE VOLUME=SYSTEM 
VOL> EXIT 

DISC FFFF MARKED OFF LINE 
INITIALIZATION COMPLETE 
TERMINAL SETUP COMPLETE 
PRESS ATTENTION FOR TSM 
@@A 

TSM> INSTALLSDT 

WOULD YOU LIKE A HARD COPY OF THE SDT. CONTENTS FILE 
TO ASSIST YOU IN THIS INSTALLATION ? (Y/N) Y 
IS THIS A COLD START (Y/N) : Y 

ENTER LINE PRINTER DEVICE ADDRESS (LP7EF8) : LP7EF8 
DO YOU WISH TO INSTALL THE ENTIRE TAPE ? (Y/N) Y 
ENTER MAGNETIC TAPE DEVICE ADDRESS (M91000) : M91000 
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ENTER THE VOLUME NAME WHICH THE SDT WILL BE 
INSTALLED ON: SYSTEM 

MOUNT MESSAGES ARE NOW TURNED OFF UNTIL INSTALLATION 
HAS COMPLETED. 

IMAGES 2 & 3 - NONRESIDENT ROUTINES ARE NOW 
BEING. . . 

IMAGE 4 - COMPRESS OBJECTS ARE NOW BEING... 

IMAGE 5 - RESIDENT SERVICES & PROCESSORS ARE NOW 
BEING. . . 


THE SDT HAS BEEN INSTALLED ACCORDING TO THE 
INSTRUCTIONS SUPPLIED BY THE USER. 

MOUNT MESSAGES ARE NOW TURNED BACK ON 

(The following steps install optional tapes.) 

TSM> AS TAP TO DEV=M9 BLO=N 
TSM> VOLMGR 

VOL> RESTORE VOLUME=SY STEM 


VOL> EXIT 


2.9.2 Overriding the Default Image 


2.9.2. 1 Selecting MSTREXT for CONCEPT 32/97 

To select MSTREXT, the extended MPX-32 Master SDT image, enter the following: 

//HALT 
/ /RST 
// CLE 
/ / GPR0=2 
//IPL=1000 

»TE 

BOOT FROM A SCSI TAPE? (REPLY Y OR N) : N 
MPX-32 MASTER SDT FOR CONCEPT 32/97 COMPUTERS 


(Continue as in the first example.) 
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2.9.2.2 Selecting MSTRALL for CONCEPT 32/2000 

To select MSTRALL as the Master SDT image when booting a CONCEPT 32/2000 
computer, do the following: 

Enter panel mode by activating the Panel Window on the windowing console. 

Halt the system, if not already halted, by selecting the halt command from 
the Panel Window menu. 

Reset the system by selecting the reset command from the Panel Window 
menu. 

Clear memory by selecting the clear mem command from the Panel 
Window menu. 

Override the default system image by changing the contents of GPRO to 
gprO : 00000001. 

Load the system by selecting the ipl command from the Panel Window 
menu. 

Enter the tape unit’s address in the sub-window. 

»TE 

BOOT FROM A SCSI TAPE? (REPLY Y OR N) : N 
MPX-32 MASTER SDT FOR CONCEPT 32/2000 COMPUTERS 


(Continue as in the first example.) 

2.9.2.3 Errors 

Errors that occur while the user is selecting the Master SDT image cause a program 
halt. After such an error occurs, GPR4 and GPR5 contain the ASCII values for the 
message BOO TF AIL and GPR6 and GPR7 contain the ASCII values for one of the 
following error messages: 

• INV GPRO — invalid value in GPRO before IPL (must be 0, 1, or 2) 

• MACHTYPE — invalid machine type from CPU status word. Valid machine types: 

0 = CONCEPT 32/2000 

3 = CONCEPT 32/67 

4 = CONCEPT 32/87 

5 = CONCEPT 32/97 

• INV IMAG — invalid image selected (mismatch of image type and machine type) 

• LOAD MOD — bad load module (mismatch of current and expected block number 
in reading image) 

• CHECKSUM — checksum error in reading image 

• IO ERROR — SDT tape I/O error 
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3.1 Introduction 

This chapter describes how to SYSGEN and test a resident system configured for a 
specific installation. Once the starter system has been installed, modifications can be 
made to the input files used by the System Generation utility, SYSGEN, to configure 
a tailored system. The modified data is saved to tape. This tape then becomes the 
user SDT. The SYSGEN utility is described in Chapter 7 of this volume. This 
chapter establishes SYSGEN in the cycle of building an MPX-32 system. 

3.2 Building the SYSGEN Input Files 


3.2.1 Building the Directive Input File 

The directive input file for SYSGEN determines the configuration of the system. The 
input file specifies such items as: hardware to support, interrupts to connect, and 
devices to use for spooled system I/O. File SG.32, provided on the Master SDT, can 
be used as a model or as a working base for preparing a SYSGEN directive file for the 
CONCEPT/32. Either edit this file or build a directive input file from scratch using 
the Text Editor. The resulting file must be uncompressed. 

The system debugger, DEBUG, can be included in the resident system by specifying a 
SYSGEN PROGRAM or USERPROG directive. This is recommended, particularly 
in an initial system. The system debugger adds approximately 300W to the size of the 
resident system. See Chapter 8 of this volume for further details on the system 
debugger. 

The size of the target system image can be reduced by one 2KW map block by 
removing compatibility mode system modules H.ALOC, H.FISE, H.MONS, and 
H.CALM using the SYSGEN NOCMS directive. Because the system image end 
address is map block bounded, and the compatibility mode system modules total less 
than one map block, the size of the system image may not be affected if the 
compatibility mode modules are removed. 


3.2.2 Building the Object Input File 

Using the directive input file, SYSGEN determines which system modules, user 
modules, interrupt handlers, and trap handlers are needed to build the target system. 
SYSGEN reads the object code for these modules and handlers from the object input 
file. An object input file, OH.32, for the CONCEPT/32 is provided on the Master 
SDT. 

User object modules can be added to the object input file. The names of these 
modules are added to the file JH.32 supplied on the Master SDT. The file is then 
compressed using the COMPRESS task. This task is described in the next section. 
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3.2.3 The COMPRESS Task 

The COMPRESS task builds a file containing any number of object files. Its input 
file must contain the ASCII names, one per record/line, of the object modules to copy 
to the output file. The logical file code for input to COMPRESS is IN. The default 
assignment of IN is to the system file JH.32. The logical file code for output from 
COMPRESS is OT. The default assignment of OT is to the system file OH.32. 

COMPRESS writes a control stream naming the files copied and lists the number of 
records each contains. It also reports any allocation or read errors. 

Syntax 

COMPRESS 

The provided object input file used by SYSGEN is created using the COMPRESS 
task. The COMPRESS input file for the SYSGEN object input file is included on the 
Master SDT and can be a model or a working base for modifying the SYSGEN object 
input file. Proper execution of SYSGEN depends on the order of the following 
modules in the COMPRESS input file: 

Oli H.IP06 must be specified before H.CALM is specified. 

• H.IOCS must be specified before H.MVMT or H.BKDM is specified. 

• H.XIOS must be specified before H.IFXIO is specified. 

• H.IFXIO must be specified before H.??XIO is specified, where ?? are any valid 
ASCII characters. 

• H.MUXO must be specified before H.??MP is specified, where ?? are any valid 
ASCII characters. 

• H.SWAPR must be specified before H.SINIT is specified. H.SWAPR and H.SINIT 
must be the last two names in the input file, if the system debugger is not to be 
configured in the system image. When the system debugger is specified 
(USERPROG=DEBUG) the unmapped portion, H.DBUG2, must be the last name 
in the input file immediately following H.SINIT. The mapped portion of the 
system debugger, H.DBUG1, can be positioned anywhere in the input file before 
H.SWAPR. 

• H.MUXO and H.IPOO must both reside in the first 64K of memory. 

• H.EXSUB must be specified before H.EXEC, H.EXEC2, or H.EXEC3 is specified. 


H.IOCS, H.IFXIO, and H.MUXO are only specified one time in the input file. 

COMPRESS OT Assignment/ 
SYSGEN OBJ Assignment 


COMPRESS IN Assignment 
JH.32 


OH.32 
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Example 

TSM> CHAN DIRE= A OB JECT 
TSM> ASSIGN IN TO JH.32 BLOCKED=Y 
TSM> ASSIGN OT TO OH. 32 BLOCKED=Y 
TSM> ASSIGN LO TO LFC=UT 
TSM> COMPRESS 

COPIED - 2 RECORDS FROM FATE pathname 
COPIED - 2 RECORDS FROM PATH pathname 


TSM> 

pathname is the name of the file from which the records were copied. 

If a complete pathname is specified in the COMPRESS input file, the complete 
pathname is displayed. If only a file name is specified in the COMPRESS input file 
and the file is found on the current working volume and directory, only the file name 
is displayed. If only a file name is specified in the COMPRESS input file and the file 
is not found on the current working volume and directory, the system volume and 
directory are searched; if the file is found, the complete pathname is displayed. If a 
file name specified in the COMPRESS input file cannot be found, a message is 
displayed and the COMPRESS task continues execution. 

3.3 Running SYSGEN 

For information on interactive and batch access, required and default assignments, and 
other aspects of running SYSGEN refer to Chapter 7 of this volume. This section 
describes a simple path for configuring a system. 

The logical file code (LFC) for a SYSGEN directive file is DIR. A modified version 
of SG.32 created by the user (called SG . DIR in the example below) can be assigned 
to DIR. 

The object input file, OH.32, can be assigned to OBJ, which is the logical file code for 
the SYSGEN object input file. A TSM ASSIGN directive can assign the input files as 
shown below. 

TSM> ASSIGN OBJ TO OH.32 BLOCKED=Y 
TSM> ASSIGN DIR TO SG.DIR BLOCKED=Y 
TSM> SYSGEN 

Alternatively, a job file can run SYSGEN in the batch mode with the above file 
assignments. 

The SYSGEN output file to contain the system image is specified with the SYSTEM 
directive in the SYSGEN directives file. The output file is then created by SYSGEN. 
File space for the output file need not be created before running SYSGEN. The file 
name specified with the SYSTEM directive is the name to specify as the system load 
file when restarting to test a system image. 
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3.4 Testing a SYSGENed System 

After the tailored image is configured, it can be tested by restarting with the 
RESTART directive or the shutdown task, J.SHUTD. Any owner can use the 
RESTART directive unless prohibited in the M.KEY file. (Refer to Chapter 5 of this 
volume for more information on RESTART.) The J.SHUTD task is available only to 
the system administrator. (Refer to Chapter 10 of this volume for more information 
on J.SHUTD.) 

Restarting without specifying an image file or performing IPL from the console causes 
the default system image (the starter system when running from SDT) to return as the 
working system image. You can continue developing configurations by using the 
editor, SYSGEN, and one-shot restarts as needed. Figure 3-1 shows the online restart 
test process in overview. 


MEMORY 



Figure 3-1 

Testing a User-Configured System 
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3.5 Terminal Initialization and System Protection 

Chapter 10 of this volume describes how to initialize terminals on MPX-32 and how 
to build an M.KEY file to authorize owners for access to the system and implement 
owner privileges. If LOGONFLE and M.KEY files exist, RESTART initializes 
terminals and M.KEY privileges. 
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4.1 Introduction 

Once a configured system is tested and ready to install in place of the starter system, 
the Volume Manager builds a user System Distribution Tape (SDT). 

4.2 Creating a User System Distribution Tape (SDT) 

A user SDT is created by the Volume Manager and is similar to the Master SDT. 
Figure 4-1 shows the layout of a user SDT. The first image on the SDT, called the 
SDT image, contains the desired system image and four essential load modules that 
must be configured in the following order for the system to be built properly: 

• Volume Formatter (J.VFMT) 

• System Mount (J.MOUNT) 

• Swapper (J.SWAPR) 

• Volume Manager (VOLMGR) 


See MPX-32 Reference Manual, Volume II, Chapter 3 for information on creating the 
SDT. 

Dining SDT processing, the load modules on the SDT image are loaded into memory 
and automatically activated. They are not restored to the system disk since directory 
information has not been retained about them. Therefore, these four modules must 
also be saved in one of the save images following the SDT image. At the VOLMGR 
prompt during SDT processing, these load modules can then be restored to the system 
disk. 

In addition to the system image and essential load modules, another group of files 
required for system operation must be saved: OPCOM, J.INIT, and J.TSM. These 
files must also be restored to disk when the VOLMGR program is activated. 
Therefore, the minimum required modules on the SDT save are: OPCOM, VOLMGR, 
J.INIT, J.MOUNT, J.TSM, J.SWAPR, and J.VFMT. 

The recommended set of load modules for an SDT is: VOLMGR, J.MOUNT, 
J.VFMT, J.SWAPR, OPCOM, J.INIT, J.TSM, J.SOUT, J.SSIN1, J.SSIN2, J.TINIT, 
J.SOEX, and EDIT. 

As boot programs cannot process multivolume headers, a user SDT should not be 
created on multivolume tape. 
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STANDARD OS 
PLUS 
SYSINIT 


J.VFMT 


J.MOUNT 


J.SWAPR 


VOLMGR 


SAVED FILES 
(MUST INCLUDE ALL KEY 
LOAD MODULES) 



DOUBLE EOF REQUIRED BY VOLMGR 


Figure 4-1 

User System Distribution Tape Format 
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4.3 Installing a User System Distribution Tape (SDT) 

All devices specified in the SYSGEN configuration should be connected. 

The procedure to install a user SDT is similar to the procedure to install a Master SDT 
as described in Chapter 2 of this volume. 

J.TINIT searches for a file in the system directory named LOGONFLE. The 
LOGONFLE can be built using the editor as documented in Chapter 10 of this 
volume. If LOGONFLE exists as a system file, J.TINIT uses the parameters 
contained in the file to initialize the terminals on the system. When terminal 
initialization is completed, the following message is displayed on the console: 

INITIALIZATION COMPLETE 
TERMINAL SETUP COMPLETE 

SYSTEM READY... PRESS ATTENTION FOR TSM 

If LOGONFLE does not exist as a system file, J.TINIT uses default parameters for all 
terminals configured in the current system image (default parameter values are 
described in Chapter 2 of this volume). Once terminal initialization is completed and 
default values are assumed, the following message is displayed on the console: 

INITIALIZATION COMPLETE 

M . ASSN DENIAL, NO LOGON FILE, DEFAULT USED 
TERMINAL SETUP COMPLETE 

SYSTEM READY... PRESS ATTENTION FOR TSM 


4.4 Saving/Restoring System Processor and Utility Load 
Modules 

Additional load modules, libraries, and files are saved and restored using Volume 
Manager save and restore directives. 
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4.5 Booting a System from a User SDT 

To boot a CONCEPT/32 computer with the system console connected to an IOP or 
MFP controller, perform the following steps on the system console: 


Enter panel mode by typing: 
System response: 

Halt the system by typing: 
System response: 

Reset the system by typing: 
System response: 

Clear memory by typing: 
System response: 

Load the system by typing: 


@@P 

// 

//HALT 

// 

/ /RST 
// 

//CLE 

// 

//!PL=address of tape unit 


The following prompts are displayed on the system console: 

This prompt is displayed only if the system debugger is configured in the 
system: 


» 


Enter TE to continue normal system operation. 

ENTER SYSTEM DEVICE CHANNEL AND SUBADDRESS: 

Enter the 2-character channel number and 2-character subaddress of the system 
volume, for example, 0800 or 0801. 

MEMORY INITIALIZATION STARTED 

MEMORY INITIALIZATION COMPLETE 

ENTER DATE AND TIME: 

Enter the date and time using the following syntax: 
date,hh[:]mn[:ss\ [, [D] [,TZ=n«m] ] 

date is the current date in one of the following formats: 

mmlddlyy 

dd-mm-yy 

ddmmmyy 

mm is the 2-digit decimal month, dd is 
the 2-digit decimal day, yy is the 2-digit decimal 
year, and mmm is the 3-ASCII-character month 
abbreviation. 

hh is the 2-digit decimal hour in 24 hour time. 

mn is the 2-digit decimal minute. 

ss is the 2-digit decimal second. If the colon 

between hh and mn is omitted, this parameter is 
ignored. 
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indicates daylight savings time is in effect. Specifying 
this field causes the internally stored binary time to be 
adjusted by one hour. 

allows the internal binary time to be biased 
by num hours. The value of num can be positive or 
negative. This field allows file times to be kept 
according to a given standard while the displayed time 
by the OPCOM TIME directive is the correct local time. 

Examples: 

06/16/81,08:45:00 
06/09/81,11:20:00 

14- 06-81,13:00:00 
03NOV81, 09:25:00 
08/29/81, 10:33, D 

15- 04-81, 19: 15: 00, D,TZ=-3 
05MAY81, 16: 15, , TZ=10 

TASK LOADING FROM TAPE STARTED 

Note: If an invalid system volume channel or subaddress was entered before 

entering the date and time, the following message appears at this 
point: 

INVALID SYSTEM OR SWAP VOLUME ENTERED 

The user must then enter a valid system volume channel and 
subaddress. Booting then continues with the FMT> prompt as show 
below. 

FMT> 

This is the Volume Formatter prompt. The Volume Formatter builds the 
on-disk structures required by the MPX-32 system. 

Important: See Chapter 13 of this volume for more information on the 
Volume Formatter. Many important user-selected parameters are only 
available at this point and cannot be changed later without removal of all user 
data on the disk. 

For successful installation of the current release of MPX-32, the minimum 
response to this prompt is the REPLACE directive (step C). 

If you are installing MPX-32 for the first time, and targeting a new disk drive 
that has never been media verified, follow step A below. As an alternative to 
step A (INITIALIZE) you may choose to run the Level II Diagnostic Media 
Verification program (HSDP or UDP/DP II controllers) or the Level II 
Diagnostic program (MFP SCSI) before installing the SDT. The instructions 
in step A can also be used to reconfigure structures built by the INITIALIZE 
directive on a currently formatted disk. 

If you are upgrading MPX-32, but wish to reconfigure currently formatted disk 
structures built by the FORMAT directive, follow step B below. 

If you are only upgrading MPX-32 with a user SDT tape, follow step C below. 


D 


TZ=num 
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Warning: Selecting steps A or B below will result in the removal of all user 
data on the disk. Be sure all important files have been saved to tape or another 
disk. 

A. The minimum response required at this prompt is: 

FMT> INITIALIZE DEVICE =devmnc DISC =dcode 

devmnc is a 6-character device mnemonic (2-character device type 
mnemonic, 2-digit hexadecimal channel number, 2-digit 
hexadecimal device subaddress); for example, DM0800 
or DM0802. 

dcode dcode is the disk storage device type code. Refer to Note 
1 in the INITIALIZE directive section of Chapter 13 for a 
list of disk type codes. 

If desired, other INITIALIZE command parameters may also be 
included on the command line. The INCLUDE parameter must not be 
used. If the FMAP parameter is specified, the line printer must be 
online. 

At the completion of the INITIALIZE command, FMT> appears 
again. When this prompt appears, follow step B below. 

B. The minimum response required at this prompt is: 

FMT> FORMAT DEVICE =devmnc VOLUME=volname 

devmnc is a 6-character device mnemonic (2-character device type 
mnemonic, 2-digit hexadecimal channel number, 2-digit 
hexadecimal device subaddress); for example, DM0800 
or DM0802. 

volname is a 1- to 16-character volume name. Valid characters are 
A through Z, 0 to 9, dot (.) and underscore (_)• 

If desired, other FORMAT command parameters may also be included 
on the command line, for example, ACCESS=, CONFIRM=, 
MAXRES=. The IMAGE parameter must not be used. If the 
BOOTFILE parameter is used, the only acceptable values are OLD 
and NEW. Volume Formatter will exit upon completion of this 
command. 

C. Enter only the following at the Volume Formatter prompt: 

FMT> REPLACE DEVICE =devmnc VOLXJME=volname 

devmnc is a 6-character device mnemonic (2-character device type 
mnemonic, 2-digit hexadecimal channel number, 2-digit 
hexadecimal device subaddress); for example, DM0800 
or DM0402. 

volname is a 1- to 16-character volume name. Valid characters are 
A through Z, 0 to 9, dot (.) and underscore (_). 

This causes the image on the user SDT to be the new default image. 
Volume Formatter will exit upon completion of this command. 
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Note: If the Volume Formatter determines that volume structures exist on the 

specified disk device, this interactive prompt is issued: 

DESTROY OPTION NOT ENABLED FOR FORMATTING VOLUME, 
VOLUME NAME =volname 
CONTINUE - Y/N? 

Enter Y to continue. If you select N, you must rewind the SDT tape 
and start the boot procedure anew. Entering DESTROY=Y on the 
command line for steps A or B will prevent this prompt from appearing. 
This is not an option for step C. 

For all steps (A, B, or C), if the CONFIRM=N parameter is not entered 
at the command line, an interactive prompt to continue is written to the 
screen. You may make changes in the dispalyed parameters or enter 
CONFIRM=N to continue. 

If any error messages are issued by Volume Formatter, take corrective 
action, rewind the SDT tape, and start the boot procedure anew. 

J. MOUNT - MOUNTING VOLUME JONES ON DM0800 

VOL> 

This is the Volume Manager prompt. If a system directory larger than the 
default is required, a system directory can be created before files on the SDT 
are restored. However, if the REPLACE command was used above (meaning 
the volume had already been formatted), the system directory may already 
exist on the disk. If the system directory already exists, do not execute the 
CREATE DIRECTORY command. 

VOL> CREATE D SYSTEM ENTRIES=,u: 

Other parameters can also be included on the directive line, for example 
OWNER=, PROJECTGROUP= , ACCESS=. 

Saved files on the SDT can now be restored. Each RESTORE directive 
processes one save image. Repeat this directive until all desired saved files on 
the SDT have been restored. Mount any unbundled software tapes on the tape 
drive and restore in the same manner. After all desired saved files are restored, 
type EXIT to exit the Volume Manager. 

VOL> RESTORE VOLUME=SYSTEM 


VOL> EXIT 

If using floppy disks, only the system image is on the boot floppy. Saved files 
are on additional floppy disks. 
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INITIALIZATION COMPLETE 
TERMINAL SETUP COMPLETE 

(or) 

INITIALIZATION COMPLETE 

M.ALOC1 DENIAL, NO LOGON FILE, DEFAULT USED 
TERMINAL SETUP COMPLETE 

If J.TINIT is restored from the SDT, one of these initialization messages is 
displayed; which one depends on whether the system file, LOGONFLE, exists 
on the currently mounted system volume. See Chapter 10 of this volume for 
details on how to build LOGONFLE. 

PRESS ATTENTION FOR TSM 

The system is now fully operational. Upon entering @ 8 A for attention, a 
prompt is issued to enter a 1- to 8-character logon owner name and 1- to 8- 
character logon key. The following characters cannot be used in owner names 
or keys: blanks, commas, semicolons, equal signs, line feeds, dollar signs, 
exclamation points, percent signs, and left or right parentheses. After entering 
a valid owner name and key, the TSM prompt is displayed and any valid TSM 
directive can be entered. 
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4.5.1 Example 

//HALT 

//RST 

//IPL=1000 

»TE 

ENTER SYSTEM DEVICE CHANNEL AND SUBADDRESS : 0800 

MEMORY INITIALIZATION STARTED 

MEMORY INITIALIZATION COMPLETE 

ENTER DATE AND TIME: 27APR90, 08 : 00 : 00 
TASK LOADING FROM TAPE STARTED 

FMT> FORMAT DEVICE=DM0800 VOLUME=JONES MAXRES=3000- 
FMT CONFIRM=Y 


Enter CONFlRM=N to continue exection, or enter any changes. 

FMT> CONFIRM=N 

DEVICE=DM0 800 — VOLUME FORMATTING SUCCESSFULLY 
COMPLETED 

J. MOUNT - MOUNTING VOLUME JONES ON DM0800 
VOL> CREATE D SYSTEM ENTR=1000 
VOL> RESTORE VOLUME=SYSTEM 


VOL> EXIT 

PRESS ATTENTION FOR TSM 
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5.1 Introduction 

An online restart halts the current system and restarts to the default or specified image. 
It does not alter control switch settings. Online restart makes separate allocation 
requests to allocate the volume descriptor (block 4) and the bootstrap blocks (blocks 
0-3) of the target disk. 

Online restart is initiated with the TSM $RESTART directive or by specifying the 
RESTART option for the J.SHUTD task. Refer to Chapter 10 of this volume for more 
information on J.SHUTD. 


5.2 Bootstrap Programs 

MPX-32 has two standard bootstrap progams. The first bootstrap program (referred to 
as OLD in the Volume Formatter chapter of this volume) loads images requiring no 
more than five Input/Output Command Doublewords (IOCDs). The second bootstrap 
program (called NEW) handles images requiring six or more IOCDs to load, as well 
as those requiring no more than five. 

The volume descriptor reserves space for five Read IOCDs. This is sufficient for 
loading images up to 50 KB (hexadecimal), but it leaves no space for additional 
IOCDs. To accommodate images requiring more than five IOCDs, the NEW bootstrap 
program itself contains the image load (Read) IOCDs. 

Online restart supports both bootstrap programs. However, when restarting to a disk 
containing an OLD-style bootstrap program, an image requiring six or more IOCDs 
cannot be used as the restart image. 

To determine the bootstrap program being used on a volume, perform a disk dump 
(DD) of the disk’s volume descriptor (block 4). If the old bootstrap program is being 
used, VO.IOCD1 contains read IOCDs. If the new bootstrap program is being used, 
VO.IOCD1 contains the following ASCII text: 

NEW DISC BOOTSTRAP. IOCDS IN BOOT BLOCK. 

Note: Because of current firmware limitations, MFP SCSI disks may not be able to 

use the NEW standard bootstrap program or NEW-style custom bootstrap 
programs. MFP SCSI images that require six or more IOCDs to load must 
use MFP ECO 88-188, Revision E or greater. A six-IOCD image can be 
restarted, but cannot be made the default image and lPLed when using less 
than Revision E. Refer to MFP ECO 88-188 for more information about the 
MFP solutions and availability. 
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5.3 TSM $RESTART Directive 

The TSM $RESTART directive is available to any user unless restricted in the 
M.KEY file. This directive can be used to: 

• restart the current default image or specified image 

• one-shot test a new system image 

• establish a new default system image 



Figure 5-1 illustrates how a default system image is established. 

Note: Because this directive does not re-initialize the Analog/Digital Interface 

(ADI) board or its associated Real-Time Peripheral (RTP) Equipment, system 
images containing the ADI handler should be brought up using IPL 
procedures. 


x 
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TSM $RESTART Directive 




Figure 5-1 

Establishing a New Default System 
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TSM $RESTART Directive 


5.4 Precautions 

Before using the TSM RESTART directive, perform the following steps: 

• Use the TSM $SIGNAL directive to notify all terminal users to stop interactive and 
batch activity and logoff. 

• Use the OPCOM LIST directive to see if any user tasks remain active. Abort any 
tasks by task number using the OPCOM ABORT directive. 

• Check batch stream activity. It should end as users logoff. 

• Because independent tasks are killed and pending I/O is lost during restart, reactive 
or re-establish independent tasks following a restart. 

5.5 Using $RESTART 


Syntax 

$RESTART [.yyi/i/e] 

sysfile is the pathname of the file containing the image to restart. This filename 
is the same as the filename supplied with the file’s SYSGEN SYSTEM 
directive. If the filename is omitted, $RESTART uses the current default 
image. 

$RESTART issuses the following prompts: 

DO YOU WISH TO RESTART? (Y OR N) : 

DO YOU WISH THIS TO BE YOUR DEFAULT IMAGE? (Y OR N) : 

Note: Do not specify an image as the default image until it has been thoroughly 

tested. 

Possible responses to these prompts and their resulting actions are: 


Restart 

Prompt 

Default 
Image Prompt 

Resulting Action 

Y 

Y 

restarts and establishes 
a new system default image 


N 

restarts to specified image, 
but does not change default 
image (one-shot test) 

N 

Y 

no restart, but establishes new 
default image 


N 

no action. MPX-32 ignores the 
RESTART directive. 


To one-shot test a new image, restart the image but respond N to the default image 
prompt. 


5-4 


Online Restart 








Errors 


5.6 Errors 

If an allocation request for the volume descriptor or the bootstrap blocks fails, 
RESTART displays one of the following messages and ends processing: 

RESTART. . .UNABLE TO ALLOCATE VOLUME DESCRIPTOR 

RESTART. . .UNABLE TO ALLOCATE BOOTSTRAP BLOCKS 


If the bootstrap program on a disk cannot be identified or properly handled (e.g. it is a 
custom bootstrap), RESTART issues the following messages and ends processing: 

RESTART. . .INVALID BOOTSTRAP ON DISC VOLUME 

RESTART. . .EXECUTE J.VFMT "REPLACE" TO WRITE NEW 
BOOTSTRAP AND IMAGE TO VOLUME 


When using the old bootstrap program, if the user restarts to an image requiring six 
IOCDs to load and specifies that image as the default, RESTART displays the 
following message but does not end processing: 

RESTART. . .NEW IMAGE TOO LARGE TO MAKE DEFAULT WITH 
CURRENT BOOTSTRAP ON DISC 

Subsequent IPLs result in loading of the previous image. 


When using the old bootstrap program, if the user restarts to an image requiring seven 
or more IOCDs to load and specifies that image as the default, RESTART displays the 
following messages and ends processing: 

RESTART. . .NEW IMAGE TOO LARGE TO RESTART WITH CURRENT 
BOOTSTRAP ON DISC 

RESTART. . .EXECUTE J.VFMT "REPLACE" TO WRITE NEW 
BOOTSTRAP AND IMAGE TO VOLUME 

If the user restarts to the default image when no system volume is configured, 
RESTART aborts with the following message: 

RESTART. . .RESTART TO DEFAULT IMAGE CANNOT BE PERFORMED 
ON REMOTE NODE 


MPX-32 Reference Volume III 


S-5/5-6 





6 Recovering the System 


6.1 Introduction 

If the operating system halts, a fresh copy of the disk file containing the operating 
system image can usually be restored into memory from the IOP console. This is an 
initial program load (IPL) and restart operation, and goes through the restart cycle 
illustrated in the previous chapter. 

The following instructions apply to input on an IOP/MFP console. When using a 
windowing console (CONCEPT 32/2000 only), refer to the CONCEPT 32/2000 
Operations Manual. 

6.2 Recovery from Disk at the Console 

To IPL and restart the default MPX-32 system from disk, enter the following at the 
console: 

/ /RST 
//IPL XXXX 

xxxx is the address of the system disk. 

Restart logic is always located on the system disk, and directs processing to the most 
recent default system file regardless of its disk location. 

6.3 Errors During Start-up 

If the system halts at or near location X’6FC’ during EPL from disk, enter GPR at the 
/ / prompt to read the contents of Rl. 

R1 contains one of the following error codes that will aid in debugging: 

Error Code Description 

1 checksum error detected on system image 

2 system image was not located at address specified to bootstrap 

3 fatal I/O error reading system image 

4 error retry attempts exhausted 

5 system does not match machine type 
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If the system halts during system initialization (SYSINIT) Phase I, R5 contains abort 
code SY01. R1 contains one of the following error codes: 

Error Code Description 

1 unrecognizable EPL device indicator 

2 invalid machine type 

3 no UDT associated with the IPL device 

4 target system image not compatible with CPU model 

5 cannot boot extended mode MPX-32 on a 32/27 

6 a device is configured at the CPU’s F-class channel, 
preventing H.SINIT from dynamically configuring an 
operator console for a 32/2000 system 

7 no priorities are available for the dynamically configured 
operator console on a 32/2000 system 

If the system halts during SYSINIT Phase II, an abort message is displayed on the 
system console. 


6.4 System Halt Analysis 

If the operating system halts, the following procedure can be used on a CONCEPT/32 
computer to determine what operations were in progress when a halt occurred. 


1. Check the CPU front panel to determine if the halt was caused by a 
hardware failure. Check interrupt active, run, halt, and any other 
pertinent indicators. 


2. Read PSW and Instruction: 

//PSW 

3. Read registers 0-7: 

a. //GPR 

b. If R7=X’54524150’, a trap, the registers contain the following 
information: 


Register 

0 

1 

2 

3 

4 

5 

6 


Contents 

PSD word 1 
PSD word 2 

real address of the instruction causing 
the trap 

instruction causing the trap 

trap status word 

ASCII trap type (e.g. MF01) 

address of registers saved at time of trap 
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If R5 = X’564D3939’ (a potential file overlap) and R7 = X’00000034’ 
(a double allocation error) occur, the registers contain the following 
information: 


RO = PSW 

R1 = VOMM FCB address 
R2 = MVTE address 

R3 = requested size in number of allocation units 
R4 = next available SMAP bit position 
R6 = internal VOMM error code 

If R5 = X’564D3939’ (a potential file overlap) and R7 = X’00000000’ 
(a double deallocation error) occur, the registers contain the 
following information: 

RO = PSW 

R1 = VOMM FCB address 
R2 = MVTE address 
R3 = MVTE address 

R4 = start SMAP bit position to perform deallocation 
R6 = SMAP start block number 

c. The registers at the time of the trap are examined by entering: 

//MA = x 

x is the contents of R6 

followed by seven returns. Each return displays the contents of the 
next register. 

d. PSD2, real address, instruction, and status is examined by entering four 
returns, one return for each item. 

4. Access system debugger, if configured: 

a. //RST 

b. //MA=B5C 

C. / /PC=X 
d. //RUN 

5. In the system debugger: 

a. DT systems with event trace enabled 

b. ABS 
C. ECHO 

d. REMAP 

e. 8E8 

f. 8E8, +40 

g. DU 0 ,nnnn 

h. DU N, 2000N 


determines current task 
dumps dispatch queue information 
nnnn is the address of H.IP00, obtained 
from the SYSGEN load map 

user task TSA 


C. DEBUG (address of system debugger or 
0 if not included in SYSGEN) 

x is the address displayed as MD=x 
resulting from the MA=B5C step 
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6. Make a dump tape, if a crash dump routine is configured 

a. Mount a tape on MT1000 

b. //HALT 
C. / /RST 

d. //MA=C2 8 C.CRDUMP (address of crash dump routine 

or 0 if H.DEBUG2 or H.DMPMT is not 
included in system) 

e. / /PC=* * is the address displayed as MD=* 

resulting from the MA=C28 step 

f. //RUN 

g. When the system is up, use ANALYZE to study the crash dump 

6.5 Automatic IPL 

If automatic IPL is hardware enabled and the system halts because of a power failure, 
the CPU initiates an IPL during the power up initialization. Automatic restart, the 
ability to restart or continue a software program that was interrupted by a power 
outage, is not supported. The software does, however, provide the required 
parameters for user implementation of the power up automatic restart feature. 

If operator intervention is inhibited, all prompts normally displayed on the system 
console during system initialization are inhibited. The system provides default 
responses for the inhibited prompts. See the Operator Intervention Inhibit section, in 
Chapter 10 of this volume. 
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7 System Generation (SYSGEN) 


7.1 Introduction 

System Generation (SYSGEN) for an MPX-32 system involves supplying a set of 
configuration directives to the SYSGEN utility. Using these directives, the utility 
creates a permanent file containing the installation specific MPX-32 system in 
memory image absolute format. 


7.2 General Description 

SYSGEN is a privileged system utility that operates in a standard MPX-32 system. 
SYSGEN can be executed in batch or interactive mode. The system where SYSGEN 
is executed must have enough free memory to hold the generated system and 
SYSGEN itself. SYSGEN requires 16KW. 

The resources that SYSGEN requires are: 

• directives 

• system object modules 


The directives can be supplied interactively or by using batch from magnetic tape, 
disk, or card reader. If supplied on a magnetic tape, the tape can include SYSGEN 
resident object modules and MPX-32 modules. The file for the resident system image 
and the system table file are permanent disk files created by SYSGEN. 

System object modules include: interrupt and trap processors such as H.IPOO and 
H.IPIT, modules that form the MPX-32 nucleus such as H.EXEC and H.REMM, 
resident system tasks such as J.SWAPR and the system debugger and the object for 
SYSINIT. These modules are provided as files to be restored from the Master SDT 
after a starter system is installed. The file naming convention for SDT files that are 
designed to be part of the resident system is OH .module. 

User object modules for interrupt handlers, resident system tasks, and user-callable 
modules defined with the MODULE directive must also be included in the object file 
for SYSGEN. 

A task called COMPRESS, provided on the Master SDT, concatenates object code. 
This task selects all required system module files for SYSGEN into the SYSGEN 
object input file. The COMPRESS input file can be modified to contain any modules, 
interrupt handlers, resident tasks, or device handlers needed to configure the resident 
operating system. See Chapter 3 of this volume for more information on COMPRESS. 

Any handlers or tasks that are SYSGENed must be Assembler object modules that 
conform to the following basic structure. The modules must begin with a handler 
address table (HAT), end with an initialization entry point, and use the following 
system macros: M.EIR, M.XIR, M.MODT, M.SVCT, and M.SVCP. 
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System tables are constructed and linked to the resident system modules, handlers, and 
user-supplied resident modules and handlers as specified by SYSGEN directives. A 
resident system image is formed and subsequently written to the dynamically acquired 
disk file specified in the SYSTEM directive. Concurrent with this process, a listing of 
directives is built and a load map of the system is generated. The symbol table can be 
saved in a system symbol table file specified with the SYMTAB directive and used in 
patching the system. 

SYSGEN uses big blocking buffers for object processing. To inhibit use of these 
blocking buffers, set option 1 before activation. 

7.3 SYSGEN Logical File Codes 

The logical file codes associated with SYSGEN are directives file (DIR), object 
module file (OBJ), base object module file (OBR), and listed output (SLO). 

DIR Default and Optional Assignments 

The file containing SYSGEN directives is assigned to logical file code DIR. The 
default assignment for DDR. is to SYC. The optional assignment for DIR is to 

pathname. 

$ASSIGN DIR TO pathname BLO=Y 
pathname is the name of a file containing the SYSGEN directives 
OBJ Default and Optional Assignments 


The file containing system resident modules is assigned to logical file code OBJ. 
There are two default assignments for OBJ: OH.32_OUT (mapped out) is the default 
if the system image has been specified for a CONCEPT 32/2000 (see the MACHINE 
directive in this chapter); OH.32 is the default if it has not. In addition, there is an 
optional assignment for OBJ: 

$ ASSIGN OBJ TO pathname BLO=Y 
pathname is the name of a file containing system resident object files 
OBR Default and Optional Assignments 

The file containing extended system modules is assigned to logical file code OBR. 

OBR must not be reassigned when building a mapped out image. 

The default for OBR is to NU (null device). There is one optional assignment for 
OBR: 


$ ASSIGN OBR TO pathname BLO=Y 
pathname is the name of the file containing extended system modules 
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SLO Default and Optional Assignments 

SYSGEN listed output — the directives list, the load map, and the error list are 
assigned to logical file code SLO. 

The default assignment for SLO is to SLO. 

There are three optional assignments for SLO: 

$ AS SIGN SLO TO {DEV =devmnc I LFC=UT I pathname } 

DEV=devmnc 

devmnc is the device mnemonic of a device to contain SYSGEN 
listed output 

LFC=UT specifies the logical file code UT 

pathname is the name of the file to contain SYSGEN listed output. 

7.3.1 LFC Summary 


LFC 

Default 

Assignment 

Optional 

Assignment 

DIR 

SYC 

pathname 

OBJ 

OH.32 (or OH.32_OUT) 

pathname 

OBR 

NU (null device) 

pathname 

SLO 

SLO 

pathname 

DEV=devmnc 

LFC=UT 


7.4 Options 

Option Description 

1 big blocking buffers inhibited 

17 each overlay module is debuggable 

18 enter SYSGEN debugger when initializing system modules 

19 enter SYSGEN debugger after a break or abort request is issued. 

Options 17, 18, and 19 are processed only when bit C.DEV of C.BIT is set. This bit 
must be set to debug SYSGEN. 
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7.5 Accessing SYSGEN 

SYSGEN is accessed from batch or TSM in this way: 

[$] [EXECUTE] SYSGEN 
or 

$RUN @SYSTEM(SYSTEM)SYSGEN 

When directive input (DIR) is assigned to a terminal, a SYS> prompt is displayed. 

To exit SYSGEN and return to TSM, use <ctrl> C. 

7.6 SYSGEN Directives 

There are three types of SYSGEN directives: 

• Section directives — begin with // and indicate the beginning of the three major 
sections: //HARDWARE, //SOFTWARE, and //END. 

• Subsection directives — begin with / and indicate the subsections within major 
sections. 

• Keyword directives — have no slash, and are part of a subsection. 

SYSGEN directives begin in column 1 of the record and contain no embedded blanks. 
An asterisk in column 1 specifies a comment line. Within a line, a blank starts 
comment processing. 

Numeric values are represented by decimal numbers unless otherwise specified. 

Directives, except TITLE, can be continued across more than one input line by 
placing a hyphen (-) as the last significant character on the line to be continued. 

SYSGEN directives are optional unless specifically described as required. In general, 
the order or presentation of SYSGEN directives is not critical within a directive 
subsection. However, if the order is critical, the individual directive discussion 
clarifies the proper order. 

File SG.32 contains a starter SYSGEN directive file. It can be used as it exists or it 
can be modified. It contains the required directives and a wide assortment of possible 
configurations that can be activated by removing the comment designation (*). 

SYSGEN directives are summarized below in the order they could appear in your 
directive file. Directives are described individually, in alphabetical order, on the 
following pages. 

Directive 


TITLE 

//HARDWARE 

/PARAMETERS 


Description 

permits identifying information to be printed on the listed 
output file 

indicates the beginning of the hardware section of directives 

designates the parameters subsection of the //HARDWARE 
section 
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Directive 

MACHINE 

IPU 

/MEMORY 

RLWU 

SIZE 

/CHANNELS 

CONTROLLER 

DEVICE 

/INTERRUPTS 

PRIORITY 

/TRAPS 

PROGRAM 

SYSTRAP 

USERPROG 

/SYSDEVS 

LOD 

POD 

SID 

SWAPDEV 

SWP 


Description 


specifies the type of computer for which the system is being 
configured 

specifies an Internal Processing Unit will be configured into the 
target system 

designates the memory subsection of the //HARDWARE section 

specifies whether read/lock write/unlock applies to all memory 

specifies the memory configuration of the target system 

designates the controller and device directives subsection of the 
//HARDWARE section 

specifies hardware channels to be configured 

defines configured hardware I/O devices 

designates the interrupt directives subsection of the 
//HARDWARE section 

specifies the interrupt configuration and the interrupt processors 
to be used by the target system 

designates the trap directives subsection of the //HARDWARE 
section 

specifies the names of trap handlers to be configured on the 
system 

specifies the default trap handlers that are to be overridden. This 
directive can only be used if a PROGRAM directive is not 
specified. 

specifies the names of trap handlers and resident system 
modules to be configured on the system if a PROGRAM 
directive is not specified 

designates the system device directives subsection of the 
//HARDWARE section 

specifies a system listed output device. Used as the default 
device in related OPCOM directives 

specifies a system punched output device. Used as the default 
device in related OPCOM directives. 

specifies a system input device (SID). Used as the default 
device in related OPCOM directives. 

specifies the default swap device 

This directive is ignored. 
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Directive 

/VP 

VP 

VPED 

//SOFTWARE 

/PARAMETERS 

SYSTEM 

SYMTAB 

DELTA 

BATCHMSG 

DISP 

LOGON 

POOL 

IOQPOOL 

MSGPOOL 

MTIM 

NTIM 

ITIM 

NOTSMEXIT 

TSMEXIT 

ITLB 

MMSG 

MRUN 

MNWI 


Description 


designates the Vector Processor subsection of the 
//HARDWARE section 

specifies the device characteristics of the Vector Processors to 
be configured 

specifies the unit-specific information for a Vector Processor 

indicates the beginning of the software section of directives 

designates the parameters subsection of the //SOFTWARE 
section 

specifies the name of the file to be used as storage for the 
generated MPX-32 resident image 

specifies the name of the file to be used as storage for the 
system symbol table 

selects optional IPU/CPU scheduling algorithm 

specifies suppression of task messages sent to users’ terminals 
or the system console 

determines the number of entries in the dispatch queue. 

specifies single or multiple logons using the same owner name 

specifies the size of the memory pool to reserve 

specifies the number of words to reserve for the IOQ memory 
pool 

specifies the number of words to reserve for the MSG 
memory pool 

specifies the number of real-time clock interrupts per second 

specifies the number of real-time clock interrupts per time unit 

specifies the time interval set for the interval timer on the 
RTOM module 

specifies that TSM remains active when not in use 

specifies that TSM exits from the system when no longer 
required 

generates an Indirectly Connected Task Linkage Block 

specifies the maximum number of no-wait messages to be sent 
by an unprivileged task 

specifies the maximum number of no-wait run request to be 
sent by a task 

specifies the maximum number of no-wait I/O requests that 
can be concurrently outstanding for a task 
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Directive 

Description 

TQFULL 

specifies the largest time quantum a single user time- 
distribution task acquires before being relinked to the bottom 
of the priority list at its base execution priority 

TQMIN 

specifies the smallest time quantum a single user task acquires 
before preemption by a higher priority user time-distribution 
task 

BATCHPRI 

specifies the execution base priority for batch jobs 

TERMPRI 

specifies the execution priority level for all tasks activated in 
the interactive terminal environment 

PATCH 

specifies a patch area to append to the MPX-32 resident image 

MODE 

requests special system operations 

SVC 

increases the size of the SVC table 

FLTSIZE 

This directive is ignored. 

RMTSIZE 

increases the size of the Resourcemark Table 

ACTIVATE 

specifies the names of load modules to be activated after the 
system has been booted. Status is not checked. 

SEQUENCE 

specifies the names of load modules to be activated after the 
system has been booted. Status is checked. 

TRACE 

allows initialization of the system trace flag word C.TRACE 

DEBUGTLC 

allows specification of the console address for the System 
Debugger’s stand-alone I/O 

PCHFILE 

provides the name of the file to be used as the patch file for 
the generated system 

DBGFBLE 

provides the name of the file containing the default task 
debugger load module for the generated system 

DPTIMO 

specifies a default time-out value to be applied to resource 
delays encountered when attempting to access a 
multiprocessor, shared-volume resource 

DPTRY 

specifies the decimal number of tries to obtain a 
multiprocessor resource before issuing a denial 

KTIMO 

specifies the number of seconds the kill directive will attempt 
to abort a task before it kills it 

DTSAVE 

specifies the elapsed time before the date/time backup 
program resumes 

SWAPSIZE 

specifies the initial swap file size 

SWAPLIM 

specifies the minimum partial swap quantum 

EXTDMPX 

specifies the location for extended memory MPX-32 and/or 
the TSA for tasks cataloged SYSTSA 
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Directive 

HELP 

DEMAND 

NODEMAND 

AGE 

BEGPGOUT 

ENDPGOUT 

MAPOUT 

NOMAPOUT 

/MODULES 

MODULE 

/OVERRIDE 

SYSMOD 

NOLACC 

NOANSI 

NOBASE 

NOCMS 

CMIMM 

CMPMM 


Description 


specifies the directory containing help files and activates 
J.HLP 

specifies which tasks are demand page processed 

inhibits demand page processing 

specifies the amount of virtual time to pass before an 
unreferenced page is considered aged during demand 
page processing 

specifies the minimum percentage of total memory 
desired for free pages on a demand page system 

specifies the maximum percentage of total memory 
desired for free pages on a demand page system 

designates mapped out as the default execution mode for 
tasks cataloged with the ENVIRONMENT SYSMAP 
keyword 

designates mapped in as the default execution mode for 
tasks cataloged with the ENVIRONMENT SYSMAP 
keyword 

designates the modules subsection of the //SOFTWARE 
section 

defines the name of an optional user module to be 
included in the MPX-32 resident image, the module 
number to be associated with the module, and the 
number of SVC callable entry points in that module 

designates the override subsection of the //SOFTWARE 
section 

replaces a system module with another module, or 
removes modules H.ALOC, H.CALM, H.FISE, and 
H.MONS 

disables the MPX-32 functionality for tracking last date, 
time, and owner name of access to task-level resource 

excludes support for ANSI labeled tapes from the system 
image 

automatically excludes support for the execution of tasks 
utilizing base register addressing from the system image 

automatically excludes support for MPX-32 Rev. 1 
compatibility mode services (modules H.ALOC, H.FISE, 
H.MONS, and H.CALM) from the system image 

returns the MPX-32 Revision 3.3 functionality for 
implicit volume mount management 

inhibits public volume dismount 


7-8 


System Generation (SYSGEN) 



SYSGEN Directives 


Directive 


Description 


NOTDEF 

NOSYSVOL 

/PARTITION 

NAME 

OWNER 

PROJECT 

OTHERS 

/SECURITY 

OWNERNAME 

PASSWORD 

SAPASSWD 

SYSONLY 

/TABLES 

CDOTS 

JOBS 

MDT 

SHARE 

TIMER 

/RMSTABLS 

ARTSIZE 

/FILES 

SMD 


excludes support for the TERMDEF Facility from the 
system image 

inhibits mounting and use of system volume for RMSS 
systems 

designates the partition subsection of the //SOFTWARE 
section 

defines Datapool or Global Common memory partitions 

specifies an owner name and access rights that apply to a 
memory partition defined by a NAME directive 

specifies a project group name and access rights which apply 
to a memory partition defined by a NAME directive 

specifies access rights that apply to users of a memory 
partition defined by a NAME directive who are not the 
owner or members of the associated project group 

specifies the security subsection of the //SOFTWARE 
section 

inhibits echoing of owner name at logon 

specifies that passwords are required for logon 

disables the PASSWORD task so that only the system 
administrator can change a password 

specifies SYSTEM as the only valid ownemame if there is 
no M.KEY file 

designates the tables subsection of the //SOFTWARE section 

specifies the size of the user CDOT array 

specifies the maximum number of batch jobs that can be 
active concurrently 

enables rapid file allocation through a memory resident 
descriptor table (MDT) 

specifies the number of entries in the shared memory table 

specifies the number of timer entries to be generated in the 
MPX-32 resident image 

designates the Resource Management System Tables 
subsection of the //SOFTWARE section 

specifies the size of the allocated resource table (ART) 

designates the system files subsection of the //SOFTWARE 
section 

This directive is ignored. 
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Directive 

Description 

SYCSIZE 

included for compatibility only. This directive is accepted by 
SYSGEN, but the results are not used in job processing. 

SGOSIZE 

included for compatibility only. This directive is accepted by 
SYSGEN, but the results are not used in job processing. 

//END 

required as the last SYSGEN directive 


7.6.1 ACTIVATE Directive 

The ACTIVATE directive names load modules to be activated by SYSINIT 
immediately after the target system is booted. Status checks are not performed on 
these tasks. This directive appears under the //SOFTWARE /PARAMETERS 
subsection. 

Syntax 

ACTIVATE=(«ame/,...«ame7) 

namel,...name7 

are the 1- to 8-character ASCII load module names to be activated, 
separated by commas. A maximum of 7 names can be entered per 
directive. 

7.6.2 AGE Directive 

The AGE directive indicates the amount of virtual time allowed to pass before an 
unreferenced page is considered aged during demand page processing. Virtual time is 
the time the task has control of the CPU. 

If NODEMAND is specified, this directive is ignored. If this directive is not specified 
and demand page processing is supported, the default is the value in effect for 
TQMIN. 

This directive appears under the //SOFTWARE /PARAMETERS subsection. 

Syntax 

AGE=xv 

xx is the amount of virtual time in milliseconds (decimal) allowed to pass 

before an unreferenced page is considered aged. If not greater than zero, 
the value in effect for TQMIN is used. 
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7.6.3 ARTSIZE Directive 

The ARTSIZE directive specifies the size of the allocated resource table (ART). The 
number of entries in the ART determines the maximum number of system resources 
that can be allocated in the system at one time. The size of each entry is 8 words. If 
this directive is not specified, 100 entries are reserved for the ART. 

This directive appears under the //SOFTWARE /RMSTABLS subsection. 

Syntax 

ARTSIZE =entries 

entries is the number of entries to be reserved for the allocated resource table 
(ART). 

7.6.4 BATCHMSG Directive 

The BATCHMSG directive inhibits batch messages from going to the system console, 
or to terminals logged on with the owner name to which the message is sent, or both. 
If the BATCHMSG directive is not specified, messages will go to all appropriate 
terminals and to the system console. 

This directive appears under the //SOFTWARE /PARAMETERS subsection. 

Syntax 

BATCHMSG= ( { (TERM I NOTERM I CONS I NOCONS} I (TERM I NOTERM}, 
{CONSINOCONS}} ) 

TERM J.TSM allows batch messages to go to all terminals except the system 
console 

NOTERM J.TSM inhibits batch messages from going to all terminals except the 
system console 

CONS J.TSM allows batch messages to go to the system console 

NOCONS J.TSM inhibits batch messages from going to the system console 

If neither TERM or NOTERM is specified, TERM is the default. If neither CONS or 
NOCONS is specified, CONS is the default. 

If both NOTERM and NOCONS are specified, task messages will not appear 
anywhere. 


7.6.5 BATCHPRI Directive 

The BATCHPRI directive specifies the execution priority level of all batch jobs. This 
directive appears under the //SOFTWARE /PARAMETERS subsection. If this 
directive is not specified, the priority level is 61. 
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Syntax 

BATCHPRI=/w 

nn is the 2-digit decimal time-distribution priority level, 55-64, to use for 

batch jobs. 

7.6.6 BEGPGOUT Directive 

The BEGPGOUT directive specifies the minimum percentage of total memory desired 
for free pages on a demand page system, the lower page-out threshold. When the 
BEGPGOUT value is reached, J.SWAPR begins writing modified, unreferenced pages 
which are queued for page-out to the swap file. 

If NODEMAND is specified, this directive is ignored. If this directive is not specified 
and demand page processing is supported, the default is 10% of the total available 
memory on the system. 

This directive appears under the //SOFTWARE /PARAMETERS subsection. 

Syntax 

BEGPGOUT=xc 

xx is a percentage (00 through 100) of the total available memory on the 

system. H.SINIT converts this percentage to the correct number of pages 
(map blocks), xx must be less than the value specified for ENDPGOUT. 

7.6.7 CDOTS Directive 

The CDOTS directive specifies the size of the user CDOT array which follows the 
fixed communications area in lower memory. The user array can be read by any task 
but can only be written into by privileged tasks. C.USERVA is the starting point of 
the user array. If this directive is not specified, no user communications region is 
established. 

If specified, this directive appears under the //SOFTWARE /TABLES subsection. 

Syntax 

CDOTS=number 

number is the decimal number of words in the user communications variable array 
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7.6.8 /CHANNELS Directive 

The /CHANNELS directive designates the controller and device subsection of the 
//HARDWARE section. This directive is required. 


Syntax 

/CHANNELS 

7.6.9 CMIMM Directive 

The CMIMM directive returns the MPX-32 3.3 revision functionality for implicit 
mount management. This includes the following features: 

• OPCOM-mounted volumes can only be dismounted using the OPCOM 
DISMOUNT directive. 

• TSM $CHANGE DIRECTORY directive allows access to any nonpublic user 
volume that is logically mounted to J.TSM. 

• Logical dismount of the last user or assigner on a nonpublic user volume causes a 
physical dismount of that volume. 

This directive appears under the //SOFTWARE /OVERRIDE subsection. 


Syntax 

CMIMM 

7.6.10 CMPMM Directive 

The CMPMM directive inhibits public volume dismount. This directive appears 
under the //SOFTWARE /OVERRIDE subsection. 

Syntax 

CMPMM 

7.6.11 CONTROLLER Directive 

The CONTROLLER directive represents one hardware channel to be configured in the 
generated system. This directive is required and must be repeated for each channel to 
be configured. The CONTROLLER directive appears under the //HARDWARE 
/CHANNELS subsection. 

The HANDLER keyword permits specification of reentrancy and controller definition 
table (CDT) generation. The type of reentrancy specified the first time a handler name 
appears in a CONTROLLER or DEVICE statement is used for the entire system. 
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The CDT per unit definition table (UDT) specification applies until another 
HANDLER keyword or CONTROLLER statement is processed. Nonpresent channels 
can be configured. 


Syntax 

CONTROLLER=rrcc,PRIORITY=/«r/ev,CLASS=cfoss [, CACHE] 

[,HANDLER={«a/ne I (name [,II,S] [,C])}] [,MUX=/ype] [,SUBCH=<z] 

tt is the 2-character ASCII device mnemonic (see Table 7-1) 

cc is the 2-digit hexadecimal channel number 

PRIORITY=mr/ev 

intlev is the hexadecimal interrupt level. If the device class (see class 
below) is memory disk, a priority interrupt is not required. If the 
interrupt is on an IOP or MFP device, the priority must be the same as 
other devices on that IOP/MFP. 

CLASS =class 

class is the device class 

D specifies 16MB addressable E class 

F specifies extended I/O 

M specifies memory disk 

[, CACHE] specifies a cache controller. All devices under a cache controller are also 
cache. 

[,HANDLER={/urme I (name [,II,S] [,C])}] 

name is the 1- to 8-character handler name (see Table 7-1). If not 
specified, the following defaults are used: H.IFXIO (XIO, 
IOP, or MFP controllers), H.MUXO (GPMC controllers), and 
H.NUXIO (null device). 

I specifies interrupt priority level reentrancy, one copy per 

channel 

S specifies system level reentrancy, one copy per system 

C specifies one CDT for each UDT 

[, MUX-type] 

type is the type of multiplex controller being configured: 

GPMC specifies general purpose multiplex controller and includes 
H.GPMCS in the system image 

XIO specifies extended I/O and includes H.XIOS in the system 

IOP specifies input/output processor and includes H.XIOS in the 

system image 

MFP specifies multi-function processor 
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[,SUBCH=a] 

a is the subchannel the controller is connected to. This subchannel will be 
used to verify proper device address specifications on subsequent device 
directives. For example, the subchannel should match the first device 
address digit. 


Table 7-1 

MPX-32 Device Type Handlers 


Device 

Mnemonic 

Device 

Handler 

Default 

Handlers 

Device Description 

CT 

H.CTXIO 

H.CTXIO 

operator console (not assignable) 

DC 

H.DCXIO 

H.DCXIO 

any disk unit except memory disk 

DM 

H.DCXIO 

H.DCXIO 

any moving head disk 

DM 

H.MDXIO 


any memory disk (HANDLER must be specified) 

DM 

H.DCSCI 


any SCSI disk (HANDLER must be specified) 

DF 

H.DCXIO 

H.DCXIO 

any fixed head disk 

MT 

H.MTXIO 

H.MTXIO 

any magnetic tape unit 

MT 

H.MTSCI 


any SCSI tape unit (HANDLER must be specified) 

M9 

H.MTXIO 

H.MTXIO 

any 9-track magnetic tape unit* 

M7 

H.MTXIO 

H.MTXIO 

any 7-track magnetic tape unit* 

CR 

H.CPMP 


any card reader 

LP 

H.LPXIO 

H.LPXIO 

any fine printer 

PT 

H.CPMP 


any paper tape reader/punch 

TY 

H.F8XIO 

H.F8XIO 

any terminal/teletypewriter (other than console) ** 

CT 

H.CTXIO 

H.CTXIO 

operator console (assignable) 

FL 

H.DCXIO 

H.DCXIO 

floppy disk 

NU 

H.NUXIO 

H.NUXIO 

null device 

CA 


N/A 

communications adapter (binary synchronous/ 
asynchronous) 

U0-U9 


N/A 

any available user-defined applications 

LF 


N/A 

line printer/floppy controller (used only with 
SYSGEN) 

ANY 

H.DCXIO 

H.DCXIO 

any nonfloppy disk except memory disk 


* When both 7- and 9-track magnetic tape units are configured, the 
designation must be 7-track. 

** GPMC terminals have H.ASMP as their default handler. 

Notes: 

Multiple controller directives are invalid on a single channel, even if the devices 
configured on the channel have mixed device types. 
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Extended I/O handlers default to system reentrant handlers. The extended I/O interrupt 
fielder (H.IFXIO) is channel reentrant. One copy should be specified for each extended 
I/O channel configured by using the I parameter. 

GPMC device handlers default to system reentrant handlers. 

If a line printer and a floppy disk are configured on the same IOP channel, only one 
CONTROLLER directive should be used. Multiple DEVICE directives specify the 
device and handler. 

The XIO common subroutines (H.XIOS) are not named within the SYSGEN directive 
file. They are automatically included during SYSGEN if MUX=XIO or MUX=IOP is 
specified. 

The GPMC subroutines (H.GPMCS) are not named within the SYSGEN directive file. 
They are automatically included during SYSGEN if MUX=GPMC is specified. 

Memory disks must be configured on channel 00 as DM00. 

The High Speed Data Handler (HSDG) is a D-class I/O controller that must be 
SYSGENed as interrupt priority reentrant, one copy per channel, using the generic 
software handler, H.HSDG. An example of the controller and device statements is: 

CONTROLLER=U040,PRIORITY=OA,CLASS=D,HANDLER= (H.HSDG, I) 
DEVICE=00,DTC=U0 

The SG.32 file on the SDT contains examples of how to SYSGEN other types of 
controllers. 

7.6.12 DBGFILE Directive 

The DBGFILE directive names the permanent file containing the default task 
debugger load module for the system being generated. This directive appears under 
the //SOFTWARE /PARAMETERS subsection. If this directive is not specified, the 
default filename is AIDDB. 

Syntax 

DBGFILE-filename 

filename is the 1- to 8-character ASCII file name of the file containing the default 
task debugger load module 

7.6.13 DEBUGTLC Directive 

The DEBUGTLC directive specifies the console address for the System Debugger’s 
stand-alone I/O. If this directive is not specified, the default address is the address of 
the system console. This directive appears under the //SOFTWARE /PARAMETERS 
subsection. 
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Syntax 

DEBUGTLC=cc 

cc is a 2-digit hexadecimal channel number. 

7.6.14 DELTA Directive 

The DELTA directive selects the optional IPU/CPU scheduler. This directive appears 
under the //SOFTWARE /PARAMETERS subsection. When DELTA is specified, 
H.EXEC2 replaces H.EXEC, and H.CPU2 replaces H.CPU. For more information, 
see the Internal Processing Unit section, in Chapter 2 of MPX-32 Reference Manual 
Volume I. 

Syntax 

DELTAscc 

cc is a 2-digit decimal number between 0 and 54 specifying the DPU bias 

task boost value 


Notes: 

The DPU directive must be present to perform the substitution. If it is not specified, the 
DELTA directive is ignored. 

Do not include H.CPU2 or H.EXEC2 in the USERPROG directive, as they are 
automatically selected. 


7.6.15 DEMAND Directive 

The DEMAND directive specifies which tasks are demand page processed. 

When the mapped out object file is assigned at SYSGEN execution, demand page 
processing is supported, unless NODEMAND is specified. The DEMAND directive 
determines which eligible tasks are demand page processed. If other than the mapped 
out object file is assigned, demand page is not supported and this directive is ignored. 

If this directive is not specified and demand page processing is supported, the 
following tasks are demand paged: 

• eligible tasks at a priority range of 55 to 64 

• tasks at priority levels 1 through 54 which are cataloged to run demand page 

For more information about task eligibility for demand paging, refer to Reference 
Manual, Volume I, Chapter 3. 

When specified, this directive appears under the //SOFTWARE /PARAMETERS 
subsection. 
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Syntax 

DEMANDS { NONE \pp } 

NONE specifies that only those tasks specified as demand page tasks when 
cataloged or linked are demand page processed 

pp is the highest priority level at which an eligible task runs in demand page 

mode. The default is 55. 

7.6.16 DEVICE Directive 

The DEVICE directive defines the configured hardware I/O devices. This directive is 
required. The DEVICE directive appears under the //HARDWARE /CHANNELS 
subsection. 

The HANDLER keyword permits specification of reentrancy and of controller 
definition table (CDT) generation. The type of reentrancy specified the first time a 
handler name appears in a CONTROLLER or DEVICE statement is used for the 
entire system. 

The CDT per unit definition table (UDT) specification applies until another 
HANDLER keyword or CONTROLLER statement is processed. Nonpresent devices 
can be configured. When the devices are added, a warm start with the devices marked 
online allows them to be used. 

The null device, NU, must be included in every configuration. 

Notes: 

Extended I/O handlers default to system reentrant handlers. 

GPMC device handlers default to system level reentrant handlers. 

A CDT is generated each time a HANDLER keyword appears, except on the first 
DEVICE statement following a CONTROLLER statement with a HANDLER 
specification. 

GPMCs support a maximum of 16 subaddresses per controller. 

For XIO devices, the subaddress specified as the aa parameter is 2 hexadecimal digits. 
The first digit is the controller address and the second digit is the device address. For 
IOP devices, the digit specified for the controller address must be equal to the digit 
specified in the CONTROLLER directive SUBCH parameter. Except for floppy 
disks, all F-class disks must specify an even device address. The device address is 
determined by the unit address plug installed in the drive or by switches in the drive. 
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The device address is the unit address multiplied by 2 and converted to its 
hexadecimal equivalent (for example, unit address 1 is device address 2, unit address 
7 is device address E). If more than one device is configured using one DEVICE 
directive, the device address and the increment (me) must be even numbers. F-class 
cartridge module drives adhere to the same conventions. SYSGEN automatically 
configures the captive media portion of the drive at the next sequential odd device 
address. Once configured, cartridge module drives are treated as individual devices. 
The removable media portion is treated as a moving head disk at the even device 
address, and the captive media portion is treated as a fixed head disk at the next 
sequential odd device address. 

7.6.1 6.1 DEVICE Syntax for Disks 

Syntax 

DEVICE= {aa I (aa,n, inc)} [,DEAL] 

[,DISC={wc/i/zcl(wJ5J2c[,D]) I devcode I {devcode I [,MIPID]) } ] [,DTC=rr] 
[,HANDLER={rtam£l(rtame[,ll,S] [,C])}] [,IO Q=mode] [,OFF] 

[,PHYSA=ccaa] [,SHR] [,ST ART -start] 

aa is the 2-digit hexadecimal device subaddress. The first digit is the 

controller address; the second digit is the device address. 

n is an optional parameter specifying the decimal number of devices starting 

at the subaddress 

inc is an optional parameter specifying the hexadecimal address increment for 

each additional device. If not specified, the default is 1. 

[,DEAL] specifies that memory for the memory disk is not allocated at system 
initialization. DEAL is valid only for single-ported memory disk. If 
DEAL is supplied with a dual-ported memory disk, it is ignored. 

[,DISC= { mdsize I ( mdsize [,D]) I devcode I ( devcode I [,MIPID]) } ] 

mdsize specifies the size in KBs if the device is a memory disk 

devcode is the 5-character device mnemonic for disk storage devices. 

It is not required for devices other than disk. See Table 7-2. 

M specifies the device is a multiport disk that is compatible with 

an MPX-32 Revision 3.3 or later system 

P specifies the device is a multiport disk that is compatible with 

an MPX-32 Revision 3.2C or earlier system 

D specifies the device is a dual-ported disk (for compatibility 

only) 

[,DTC=/r] tt is a 2-character device mnemonic (see Table 7-1). If not specified, the 
device mnemonic specified on the associated CONTROLLER directive is 
used. 
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[,H ANDLER= { name I («awe[,ll,S] [,C]) } ] 

name is the 1- to 8-character handler name (see Table 7-1). If not 
specified, a default handler is assigned in the following 
manner: 

• If the device has a default handler associated with it, that 
handler is assigned to the device. 

• If the device does not have a default handler associated 
with it, the device is assigned the same handler as the 
device which was most recently defined to the subchannel 
to which this device is being defined (aa above). If no 
device has yet been defined to this subchannel, then the 
handler associated with the CONTROLLER directive for 
the subchannel is assigned. 

An error is generated if an invalid handler is selected by 
default. 

This parameter must be specified for a memory disk 
(H.MDXIO). 

I specifies interrupt priority level reentrancy, one copy per 

channel 

S specifies system level reentrancy, one copy per system 

C specifies one CDT for each UDT 

[,IOQ =mode] 

is used by the IOP and GPMC to indicate the I/O queue entries are to be 
linked from the UDT (IOQ=DEV) or from the CDT (IOQ=CONT). The 
default mode is IOQ=CONT. However, most handlers provide their own 
initialization for this parameter and ignore any value specified by 
SYSGEN. Therefore, this parameter should not be used for any standard 
MPX-32 handler supplied by Encore unless such a requirement is specified 
in the installation instructions for that handler. 

[,OFF] specifies that the device or devices described by this directive are to be 
SYSGENed in an offline state 

[,PHYSA=cca«] 

specifies the physical (bus) channel address and device subaddress for 
devices. Used when logical channel and subaddress do not match the 
physical channel and subaddress. 

ccaa is the 2-digit hexadecimal channel address and 2-digit 
hexadecimal device subaddress 

[,SHR] specifies the device is a shared device 

[,START=srarr] 

start specifies the decimal start map block number of the memory disk. If 
not specified, default is the highest possible address in memory. 
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Notes: 

Memory disks must be configured on the even subaddresses of channel 00. The 
subaddress of the memory disk cannot be the same as the null device subaddress. 


Table 7-2 

Disk Device Codes 


Disk 

Disk Code 


Reserved FE004 

1.2MB floppy disk - Class F device FL001 

40MB moving head disk - Class F device MH040 

80MB moving head disk - Class F device MH080 

160MB moving head disk - Class F device MH160 

300MB moving head disk - Class F device MH300 

340MB (Winchester) moving head disk - Class F device MH340 
600MB moving head disk - Class F device MH600 

5MB fixed head disk - Class F device FH005 

32MB cartridge module disk - Class F device CD032 

Any nonfloppy disk - Class F device ANY 


7.6.16.2 DEVICE Syntax for Console, Terminals and 8-Line Serial Printers 
Syntax 

DEVICE={tf<a I (aa,n,inc) } [, CACHE] [,DTC=/f] [,FEOP] [,FULL] 

[,HANDLER={n<2mel (name[,\\,S\ [,C]) } ] [,IOQ=moJe] [,LINSIZ=x] [,OFF] 
[,PAGE=y] [,PHYSA -ccaa] [,SLPR] 


aa is the 2-digit hexadecimal device subaddress. The first digit is the 

controller address; the second digit is the device address. 

n is an optional parameter specifying the decimal number of devices starting 

at the subaddress 


inc is an optional parameter specifying the hexadecimal address increment for 

each additional device. If not specified, the default is 1. 

[, CACHE] specifies a cache device. This option is not necessary if the associated 
CONTROLLER statement includes CACHE. 


[,DTC=/r] tt is a 2-character device mnemonic (see Table 7-1). If not specified, the 
device mnemonic specified on the associated CONTROLLER directive is 
used. 

[,FEOP] specifies that J.SOUT inhibits the normal initial form feed and terminates 
all printing with an additional form feed, if specified for LP device. FEOP 
is applicable only on electrostatic printers and laser printers that retain the 
last page of output until a form feed (EJECT) is received. 
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[,FULL] allows full-duplex mode of operation if FULL and NOECHO are 

specified in LOGONFLE. This causes a UDT to be created for both the 
read and write subaddresses even though only the read subaddress is 
specified. Valid only for 8-line asynch devices. 

[,HANDLER= { name I (/tame[, ll,S] [,C]) } ] 

name is the 1- to 8-character handler name (see Table 7-1). If not 
specified, a default handler is assigned in the following 
maimer: 

• If the device has a default handler associated with it, that 
handler is assigned to the device. 

• If the device does not have a default handler associated 
with it, the device is assigned the same handler as the 
device which was most recently defined to the subchannel 
to which this device is being defined ( aa above). If no 
device has yet been defined to this subchannel, then the 
handler associated with the CONTROLLER directive for 
the subchannel is assigned. 

An error is generated if an invalid handler is selected by 
default. 

I specifies interrupt priority level reentrancy, one copy per 

channel 

S specifies system level reentrancy, one copy per system 

C specifies one CDT for each UDT 

[,IOQ -mode] 

is used by the IOP and GPMC to indicate the I/O queue entries are to be 
linked from the UDT (IOQ=DEV) or from the CDT (IOQ=CONT). The 
default mode is IOQ=CONT. However, most handlers provide their own 
initialization for this parameter and ignore any value specified by 
SYSGEN. Therefore, this parameter should not be used for any standard 
MPX-32 handler supplied by Encore unless such a requirement is specified 
in the installation instructions for that handler. 

[,LINSIZ=x] x specifies the number of characters per line for TSM devices. The 
default is 80. 

[,OFF] specifies that the device or devices described by this directive are to be 
SYSGENed in an offline state 

[,PAGE=y] y specifies the number of lines per screen for TSM devices or number of 
lines per page for listed output devices. Zero prevents ENTER CR FOR 
MORE. TTie default is 24 lines. 

[,PHYSA=caia] 

specifies the physical (bus) channel address and device subaddress for 
devices. Used when logical channel and subaddress do not match the 
physical channel and subaddress. 
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( 


ccaa is the 2-digit hexadecimal channel address and 2-digit 
hexadecimal device subaddress 

[,SLPR] indicates the device is a serial printer. See Notes. 

Notes: 

The CACHE parameter can be applied to ACM devices (H.F8XIO), to quadruple the 
normal I/O time out. This is intended for slow spooling devices with large internal 
buffers using XON/XOFF (WXON) flow control. The CACHE parameter can also be 
applied to a buffered tape processor (BTP), but not to the cache disk accelerator. 

When SLPR is specified: the HANDLER parameter must equal H.F8XIO; the 
LINESIZ and PAGE parameter must be used (suggested settings LINSIZ=133 and 
PAGE=60); the DEVICE FULL parameter must not be specified. If the printer has a 
large buffer, the DEVICE CACHE parameter should be specified to extend the normal 
time-out. This will account for long I/O wait times (XOFF) while the buffer is 
purging. 

7.6.16.3 DEVICE Syntax for Tape Drives 
Syntax 

DEVICE= {aa I (aa,n,inc)) [.ANSI] [, CACHE] [,DTC=rr] 

[,HANDLER={«amel(rt(2me[,ll,S] [,C]) } ] [,IO Q=mode] [.OFF] [,PHYSA=ccaa] 
[,QITD] [,SHR] 

aa is the 2-digit hexadecimal device subaddress. The first digit is the 

controller address; the second digit is the device address. 

n is an optional parameter specifying the decimal number of devices starting 

at the subaddress 

inc is an optional parameter specifying the hexadecimal address increment for 

each additional device. If not specified, the default is 1 . 

[,ANSI] specifies this drive is used only for ANSI tape processing. Refer to 

Reference Manual Volume II, Chapter 7, for details. This parameter does 
not restrict the system administrator. 

[, CACHE] specifies a cache device. This option is not necessary if the associated 
CONTROLLER statement includes CACHE. 

[,DTC=ff] tt is a 2-character device mnemonic (see Table 7-1). If not specified, the 
device mnemonic specified on the associated CONTROLLER directive is 
used. 


( 
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[, HANDLERS { name I (name[, II, S] [,C]) } ] 

name is the 1- to 8-character handler name (see Table 7-1). If not 
specified, a default handler is assigned in the following 
manner: 

• If the device has a default handler associated with it in 
Table 7-1, that handler is assigned to the device. 

• If the device does not have a default handler associated 
with it, the device is assigned the same handler as the 
device which was most recently defined to the subchannel 
to which this device is being defined (aa above). If no 
device has yet been defined to this subchannel, then the 
handler associated with the CONTROLLER directive for 
the subchannel is assigned. 

An error is generated if an invalid handler is selected by 
default. 

I specifies interrupt priority level reentrancy, one copy per 

channel 

S specifies system level reentrancy, one copy per system 

C specifies one CDT for each UDT 

[,IO Q=mode] 

is used by the IOP and GPMC to indicate the I/O queue entries are to be 
linked from the UDT (IOQ=DEV) or from the CDT (IOQ=CONT). The 
default mode is IOQ=CONT. However, most handlers provide their own 
initialization for this parameter and ignore any value specified by 
SYSGEN. Therefore, this parameter should not be used for any standard 
MPX-32 handler supplied by Encore unless such a requirement is specified 
in the installation instructions for that handler. 

[,OFF] specifies that the device or devices described by this directive are to be 
SYSGENed in an offline state 

[,PHYSA=caja] 

specifies the physical (bus) channel address and device subaddress for 
devices. Used when logical channel and subaddress do not match the 
physical channel and subaddress. 

ccaa is the 2-digit hexadecimal channel address and 2-digit 

hexadecimal device subaddress 

[,QITD] specifies a quarter-inch tape drive 

[,SHR] specifies the device is a shared device 


7-24 


System Generation (SYSGEN) 



SYSGEN Directives 





Notes: 

The CACHE parameter can be applied to ACM devices (H.F8XI0), to quadruple the 
normal I/O time out. This is intended for slow spooling devices with large internal 
buffers using XON/XOFF (WXON) flow control. The CACHE parameter can also be 
applied to a buffered tape processor (BTP), but not to the cache disk accelerator. 

7.6.16.4 DEVICE Syntax for IOP Printers and Null Device 

Syntax 

DEVICE={na I (aa,n,inc ) } [, CACHE] [,DTC=tt] [,FEOP] 

[,HANDLER={«tf/we I {name[, II, S] [,C])}] [,\QQi=mode] [,OFF] [,PHYSA=ccaa] 
[,SHR] [, SPOOL =(code,code,...)] 


is the 2-digit hexadecimal device subaddress. The first digit is the 
controller address; the second digit is the device address. 

is an optional parameter specifying the decimal number of devices starting 
at the subaddress 

is an optional parameter specifying the hexadecimal address increment for 
each additional device. If not specified, the default is 1 . 

specifies a cache device. This option is not necessary if the associated 
CONTROLLER statement includes CACHE. 

tt is a 2-character device mnemonic (see Table 7-1). If not specified, the 
device mnemonic specified on the associated CONTROLLER directive is 
used. 

specifies that J.SOUT inhibits the normal initial form feed and terminates 
all printing with an additional form feed, if specified for LP device. FEOP 
is applicable only on electrostatic printers and laser printers that retain the 
last page of output until a form feed (EJECT) is received. 

[, HANDLER= { name I (/tam£[,ll,S] [,C]) } ] 

name is the 1- to 8-character handler name (see Table 7-1). If not 
specified, a default handler is assigned in the following 
manner: 

• If the device has a default handler associated with it in 
Table 7-1, that handler is assigned to the device. 

• If the device does not have a default handler associated 
with it, the device is assigned the same handler as the 
device which was most recently defined to the subchannel 
to which this device is being defined {aa above). If no 
device has yet been defined to this subchannel, then the 
handler associated with the CONTROLLER directive for 
the subchannel is assigned. 


aa 

n 

inc 

[.CACHE] 

[,DTC=rr] 

[,FEOP] 
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An error is generated if an invalid handler is selected by 
default. 

I specifies interrupt priority level reentrancy, one copy per 

channel 

S specifies system level reentrancy, one copy per system 

C specifies one CDT for each UDT 

[,IO Q=mode] 

is used by the IOP and GPMC to indicate the I/O queue entries are to be 
linked from the UDT (IOQ=DEV) or from the CDT (IOQ=CONT). The 
default mode is IOQ=CONT. However, most handlers provide their own 
initialization for this parameter and ignore any value specified by 
SYSGEN. Therefore, this parameter should not be used for any standard 
MPX-32 handler supplied by Encore unless such a requirement is specified 
in the installation instructions for that handler. 

[,OFF] specifies that the device or devices described by this directive are to be 
SYSGENed in an offline state 

[,PHYSA=cctfa] 

specifies the physical (bus) channel address and device subaddress for 
devices. Used when logical channel and subaddress do not match the 
physical channel and subaddress. 

ccaa is the 2-digit hexadecimal channel address and 2-digit 

hexadecimal device subaddress 

[,SHR] specifies the device is a shared device 

[, SPOOL -(code, code, ...)\ 

indicates the device is available for automatic selection as the destination 
device for spooled printed and punched output, code consists of 2- 
character codes separated by commas. The codes and their use for output 
are: 


BL 

batch 

SLO 

BB 

batch 

SBO 

RL 

real-time 

SLO 

RB 

real-time 

SBO 


Notes: 

The CACHE parameter can be applied to ACM devices (H.F8XIO), to quadruple the 
normal I/O time out. This is intended for slow spooling devices with large internal 
buffers using XON/XOFF (WXON) flow control. The CACHE parameter can also be 
applied to a buffered tape processor (BTP), but not to the cache disk accelerator. 

7.6.17 DISP Directive 

The DISP directive determines the number of entries in the dispatch queue. One entry 
is used for each concurrently operating task. Each entry requires 64 words of resident 
image storage. This directive appears under the //SOFTWARE /PARAMETERS 
subsection. 
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Syntax 

DISP -entries 

entries specifies the decimal number of entries in the dispatch queue. This value 
cannot exceed 255 and must be at least 8. If not specified, the default is 
10 . 

7.6.18 DPTIMO Directive 

The DPTIMO directive specifies a time-out value for resource delays encountered 
when attempting to access a multiprocessor, shared-volume resource. If this directive 
is not specified, the system assigns a sufficient number of time units to result in a 
delay a maximum of 1 second long. This directive appears under the //SOFTWARE 
/PARAMETERS subsection. 

Syntax 

DPTIMO -num 

num is the decimal number of time units to wait before timing out. Because a 

delay request is likely to be entered within a time unit, num should be a 
value large enough to result in delay one time unit longer than the actual 
maximum delay desired. For example, if NTIM is 1 and MTIM is 60, 
DPTIMO must be 61 (1 second plus 1 time unit) to ensure a maximum 
delay of 1 second. (For more information on time units, see the MTIM 
Directive and NTIM Directive section of this chapter.) 

7.6.19 DPTRY Directive 

The DPTRY directive specifies the decimal number of times that a system tries to 
obtain a multiprocessor resource before returning a denial. If this directive is not 
specified, the default is 0, which causes the system to try until the resource is 
obtained. This directive appears under the //SOFTWARE /PARAMETERS 
subsection. 

Syntax 

DPTRY =num 

num is the decimal number of tries to obtain a multiprocessor resource. 


7.6.20 DTSAVE Directive 

The DTSAVE directive specifies the decimal number of minutes to elapse before 
J.DTSAVE is resumed. If this directive is not specified, the default time is 5 minutes. 
This directive appears under the //SOFTWARE /PARAMETERS subsection. 
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Syntax 

DTSAVE -time 

time is the number of minutes to elapse before J.DTSAVE resumes. 

7.6.21 //END Directive 

The //END directive is required as the last directive in the SYSGEN directives file. 


Syntax 

//END 

7.6.22 ENDPGOUT Directive 

The ENDPGOUT directive specifies the maximum percentage of total memory desired 
for free pages on a demand page system, the upper page-out threshold. J.SWAPR 
stops writing pages queued for page-out to the swap file when the ENDPGOUT value 
is reached or the queues are empty. 

If NODEMAND is specified, this directive is ignored. If this directive is not specified 
and demand page processing is supported, the default is 25% of the total available 
memory on the system. 

This directive appears under the //SOFTWARE /PARAMETERS subsection. 

Syntax 

ENDPGOUT=xx 


xx is a percentage (00 through 100) of the total available memory (SRAM 

only) on the system. H.SINIT converts this percentage to the correct 
number of pages (map blocks), xx must be greater than the value specified 
for BEGPGOUT. 

7.6.23 EXTDMPX Directive 

The EXTDMPX directive can be used on a system wide basis to designate the starting 
address of the TSA and extended MPX-32 (if configured). This directive appears 
under the //SOFTWARE /PARAMETERS subsection. 

This directive applies only to the TSA when extended MPX is not configured. Refer 
to Reference Manual Volume I, Chapter 3, for information on how to configure 
extended MPX-32. 
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The NOTSA or TSA option is ignored when the load module has been cataloged in 
the compatible mode, or using the TSA keyword in the cataloger EXTDMPX 
directive. The NOTSA or TSA option is effective only when the load module has 
been cataloged using the SYSTSA keyword in the Cataloger EXTDMPX directive. 
When this requirement has been met, a TSM or M.PTSK request will override the 
SYSGEN request. 

If the EXTDMPX directive is not used, the default is MINADDR and NOTSA. This 
directive establishes the default TSA and extended MPX-32 logical starting address 
unless overridden via the CATALOG, TSM, or M.PTSK assignments. 


Syntax 

EXTDMPX= { logmapbl I MAXADDR I MINADDR} [, NOTSA I ,TSA] 


logrmpbl is a decimal value between 64 and 2047 that specifies a starting map 

block in the task’s logical address space where the TSA (optionally) and 
extended MPX-32 (if configured) are positioned. The NOTSA/TSA 
keyword controls positioning of the TSA. 

MAXADDR positions the TSA (optionally) and extended MPX-32 (if configured) at 
the top of the the task’s logical memory. The NOTSA/TSA keyword 
controls positioning of the TSA. 

MINADDR positions the TSA and extended MPX-32 (if configured) at the bottom of 
the task’s logical memory above MPX-32 (when mapped in), and below 
the task’s DSECT. The TSA keyword defaults to NOTSA for 
MINADDR. 


NOTSA directs the logical position of the TSA to be above MPX-32 (when 
mapped in) and below extended MPX-32 (if configured and at 
MINADDR), and below the task’s DSECT. 

TSA directs the repositioning of the TSA in accordance with the MAXADDR, 

or logmapbl specification used. For MAXADDR the TSA is located at 
the top of the task’s logical memory, followed by extended MPX-32 (if 
configured). For logmapbl , the TSA logically starts at logmapbl, 
followed by extended MPX-32 (if configured). 


Note: An error, *** INVALID KEYWORD, is displayed on the user’s terminal (or 

printed to the listed output) if NOTSA or TSA keywords are incorrectly 
spelled. SYSGEN aborts and no image is built. 

At runtime, values for MAXADDR or logmapbl that conflict with the task’s 
code, data, or partition memory requirements cause an abnormal termination 
in the task activation. 
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7.6.24 /FILES Directive 

The /FILES directive designates the system files subsection of the //SOFTWARE 
section. This section is included for compatibility only. 

Syntax 

/FILES 

7.6.25 FLTSIZE Directive 

The FLTSIZE directive is included for compatibility and is ignored by SYSGEN. 
Items following this directive on the same line are ignored. 

Syntax 

FLTSIZE 

7.6.26 //HARDWARE Directive 

The //HARDWARE directive indicates the beginning of the hardware configuration 
section of directives. This directive is required. 

Syntax 

//HARDWARE 

7.6.27 HELP Directive 

The HELP directive specifies the volume and/or directory containing help files. The 
default is @SYSTEM A (HELP) directory. The directive also activates J.HLP. This 
directive appears under the //SOFTWARE /PARAMETERS subsection. 

Syntax 

HELP [y 0\-=volname\ [,DIR =dirname] 

volname is the volume where help files are located. If not specified, the default is 
the SYSTEM volume. 

dirname is the directory where help files are located. If not specified, the default is 
the HELP directory. 
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7.6.28 /INTERRUPTS Directive 

The /INTERRUPTS directive designates the interrupt subsection of the 
//HARDWARE section. This directive is required. 

Syntax 

/INTERRUPTS 


7.6.29 IOQPOOL Directive 

The IOQPOOL directive specifies the number of words to reserve at SYSGEN for the 
IOQ memory pool. This directive appears under the //SOFTWARE /PARAMETERS 
subsection. If this directive is specified, the IOQ memory pool is used only for IOQ 
requests. IOQ memory pool is required for each preallocated IOQ and for each I/O in 
progress. 

To estimate the minimum size to request for the IOQ memory pool, calculate the 
average IOQ size (26 words plus the length in words of the associated I/O command 
list (IOCL)). (The length of the IOCL varies according to the I/O operation and the 
device.) The calculated size is rounded up to a doubleword. Then multiply the 
average IOQ size by the estimated number of IOQs in use at any one time. 

The size of the IOQPOOL should be greater than the worst case I/O load. If the 
IOQPOOL becomes used up, causing rollover to miscellaneous memory pool, the 
probability of deadlock occurring from requesting memory pool increases. When 
rollover to miscellaneous memory pool occurs, a bit (C.ROLIOQ) is set in the 
communications region. 

If the MNWI directive is not specified, unprivileged tasks can have one wait I/O or 
five nowait I/Os outstanding at a given time. Privileged tasks can have any number of 
no wait I/Os outstanding. 


Syntax 

IOQPOOL=«[, PERMIOQ [, NOROLL]] 

n is the decimal number of words to reserve. If n is not specified, an IOQ 

memory pool is not reserved and the memory pool that is specified by the 
POOL directive handles any IOQ requests. 

PERMIOQ specifies static IOQ. This parameter is valid only when parameter n is 

greater than 0. PERMIOQ enables an IOQ to be allocated when the file is 
opened and deallocates that IOQ when the file is closed. If PERMIOQ is 
not specified, IOQs are allocated as described in the Operating System 
Memory Allocation section, in Chapter 3 of MPX-32 Reference Manual, 
Volume I. 

NOROLL specifies no rollover to the memory pool specified by the POOL directive 
for static IOQs when the IOQ memory pool is full. 
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7.6.30 IPU Directive 

The IPU directive specifies an BPU will be configured into the system. This directive 
appears under the //HARDWARE /PARAMETERS subsection. 

Syntax 

IPU 

7.6.31 ITIM Directive 

The ITIM directive provides the expiration time interval of the RTOM interval timer. 
This directive appears under the //SOFTWARE /PARAMETERS subsection. If this 
directive is not specified, the default time interval is 38.4 microseconds. 

Syntax 

ITIM=va/ue 

value is the quantity expressed in tenths of microseconds of an RTOM interval- 
timer time quantum. For example, 38.4 microseconds is represented as 
384. 

7.6.32 ITLB Directive 

The ITLB directive generates an Indirectly Connected Task Linkage Block. This 
directive appears under the //SOFTWARE /PARAMETERS subsection. One ITLB 
directive is required for each indirectly linked task concurrently active in the system. 

Syntax 

[TLB-intlevel 

intlevel is the 2-character hexadecimal interrupt priority level where the task will 
be indirectly connected 

7.6.33 JOBS Directive 

The JOBS directive specifies the maximum number of batch jobs that can be 
concurrently active. Any number is valid. However, a large number can cause an 
increase in system response time due to increased system overhead associated with 
J.TSM processing. Therefore, 10 is suggested. If this directive is not specified, the 
default is 1. 

This directive appears under the //SOFTWARE /TABLES subsection. 
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Syntax 

JOBS=number 

number is the number of entries in the job table. 

7.6.34 KTIMO Directive 

The KTIMO directive specifies the number of seconds the kill directive will attempt to 
abort a task before it kills it. If 0 is specified, an immediate kill is performed. If this 
directive is not specified, a kill is performed after 10 seconds. This directive appears 
under the //SOFTWARE /PARAMETERS subsection. 

Syntax 

KT\MO=number 

number is the decimal number of seconds to attempt an abort 

7.6.35 LOD Directive 

The LOD directive specifies a system listed output device that is the default device for 
SLO. This directive is required if a line printer is configured. This directive appears 
under the //HARDWARE /SYSDEVS subsection. 

Syntax 

LOD=devmnc [,IBP] 

devmnc is the 2-character device mnemonic (see Table 7-1), the 2-digit 
hexadecimal channel number, and the 2-digit hexadecimal device 
subaddress. 

IBP inhibits banner page produced on the SLO device 

7.6.36 LOGON Directive 

The LOGON directive specifies whether users may log into MPX-32 multiple times 
using the same owner name. It also provides an option for restricting the owner name 
"SYSTEM" from logging on to more than one TSM device at a time. If the LOGON 
directive is not specified, J.TSM allows one logon per owner name. 

This directive appears under the //SOFTWARE /PARAMETERS subsection. 
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Syntax 

LOGON= { MULTI [,NOSYS] I SINGLE } 

MULTI J.TSM allows a user to log on multiple times using the same owner name 
[,NOSYS] restricts the owner name "SYSTEM" to one logon at a time 
SINGLE J.TSM allows one logon per owner name 

When an owner name is logged on multiple times, all messages and signals directed to 
that owner name go to all terminals logged on with that owner name. (See the 
BATCHMSG directive in this chapter for information on inhibiting task messages.) 

Note: This directive was previously called LOGIN. "LOGIN” in place of 

"LOGON” remains valid syntax. 


7.6.37 MACHINE Directive 

The MACHINE directive indicates the type of computer for which the resultant 
system is being configured. If this directive is not specified, any CONCEPT/32 
machine can be used. 

If the type of computer specified is a CONCEPT 32/2000, the system file 
OH.32_OUT is dynamically assigned as SYSGEN’s object module file (OBJ) and a 
mapped out image is built. If any other type of computer is specified or if the entire 
directive is omitted, OH.32 is assigned to OBJ and a mapped in image is built. These 
file assignments can be overridden by assigning OBJ before running SYSGEN. (See 
section 7.3 of this chapter for more information on assigning the object module file.) 

If this is done, the MACHINE directive indicates only the computer type; the image is 
built from the specified object module file. Any conflicts are resolved by SYSGEN in 
a later phase or by H.SINIT. 

The MACHINE directive controls the automatic console configuration functionality. 
Automatic console configuration is the process of dynamically configuring the 
operator console for a CONCEPT 32/2000 system. This console will be dynamically 
configured at the CPU’s F-class channel. 

If no MACHINE directive is specified or if a CONCEPT 32/2000 is specified 
(MACHINE=2 000), the operator console will be dynamically configured when the 
resultant system image is booted on a CONCEPT 32/2000 machine. The operator 
console will not be dynamically configured if a computer type other than a CONCEPT 
32/2000 is specified or the system image is booted on a machine other than a 
CONCEPT 32/2000. 

If this directive is specified, it must be the first directive in the //HARDWARE 
/PARAMETERS subsection. 


Syntax 

MACHINE^/*? 

type is the machine type 3267, 3287, 3297 or 2000. 
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7.6.38 MAPOUT Directive 

The MAPOUT directive designates that the default execution mode for all tasks 
cataloged with the ENVIRONMENT keyword SYSMAP is executed with MPX-32 
mapped out of the task’s address space. If neither the MAPOUT or NOMAPOUT 
directive is specified the compatible or NOMAPOUT mode is the default. 

If the MAPOUT directive is present with a MACHINE directive specifying any type 
other than 2000, or if both MAPOUT and NOMAPOUT are specified, a 
★ ★★CONFLICTING OPTIONS error is generated by SYSGEN. If this error occurs, 
SYSGEN aborts and no image is produced. 

This directive appears under the //SOFTWARE /PARAMETERS subsection. 

Syntax 

MAPOUT 

7.6.39 MDT Directive 

The MDT directive enables rapid file allocation through a memory resident descriptor 
table (MDT). The MDT’s parameters are defined by this directive, and module 
H.MDT is included in the resident operating system. This directive appears under the 
//SOFTWARE /TABLES subsection. 

Syntax 

MDT=« [,BLOC=6] 

n specifies the decimal number of MDT entries. MDT entries are 192 words 

in length. To accommodate collision resolution, the actual number 
allocated is 25% greater than the specified number. 

[,BLOC=/>] specifies the decimal starting physical map block number. If not 
specified, the default is the highest contiguous memory available. 

If the specified starting map block is not available, initialization processing halts and 
an abort code is displayed at system initialization. 

7.6.40 /MEMORY Directive 

The /MEMORY directive designates the memory subsection of the //HARDWARE 
section. This directive is required. 

Syntax 

/MEMORY 
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7.6.41 MMSG Directive 

The MMSG directive specifies the maximum number of no-wait messages that an 
unprivileged task can send. If this directive is not specified, the default is 5. This 
directive appears under the //SOFTWARE /PARAMETERS subsection. 

Syntax 

MMSG -num 

num is the maximum number of no-wait messages to be sent by a unprivileged 

task. 

7.6.42 MNWI Directive 

The MNWI directive specifies the maximum number of no-wait I/O requests that can 
be concurrently outstanding for a task. If this directive is not specified, the default is 
5. This directive appears under the //SOFTWARE /PARAMETERS subsection. 

Syntax 

MNWI -num 

num is the maximum number of no- wait I/O requests that can be concurrently 

outstanding for a task. 

7.6.43 MODE Directive 

The MODE directive requests the following special system operations: 

• Continuous Batch — Batch stream input from SID is processed until the job control 
statement $$$ is encountered. All $$ job control statements are ignored. 

• Inhibit Banner Page — Suppresses the banner page produced by system output 
tasks when processing SLO files. 

• Inhibit Mount Message — Suppresses the mount message produced by J.MOUNT. 
This specification is not valid with multivolume magnetic tape operations. 

• Dump — Performs a dump if an independent task aborts. 

• Scratchpad Locations — Does not zero unused CPU scratchpad locations at 1PL. 

• Inhibit Operator Intervention — Suppresses all prompts normally displayed on the 
system console during system initialization. 

• Real-time Accounting — Turns real-time accounting on or off. 

Specify a separate MODE directive for each mode desired. If no MODE directive is 
specified, only real-time accounting is functional in the resulting system image. If this 
directive is specified, it appears under the //SOFTWARE /PARAMETERS subsection. 
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Syntax 

MODE=n?oJe 

mode is any of the following: 

DUMP sets dump request for aborting real-time tasks 

LSPA inhibits zeroing of unused scratchpad locations during IPL 

processing. If not specified, the IPL process zeroes all unused 
CPU scratchpad locations. 

ONRA turns real-time accounting on. (This is the default.) 

OFRA turns real-time accounting off 
SCBT sets continuous batch 

S1BP sets inhibit banner page 

SIMM sets inhibit mount messages for nonmultivolume magnetic 

tape operations 

SNOP sets inhibit operator intervention 

7.6.44 MODULE Directive 

The MODULE directive names optional user modules to be included in the MPX-32 
resident image. One MODULE directive is required for each user module to be 
included. This directive appears under the //SOFTWARE /MODULES subsection. 


Syntax 

MODULE=(name,module,entpoints) 

name is the 1- to 8-character ASCII module name. The name cannot contain a 
comma, an equal sign, or a left or right parenthesis. The module name 
N.ACXRF is reserved for use only as module number 12. 

module is a 2-digit decimal number representing the internal identification number 
of the module. Modules 00 through 12 are reserved for MPX-32 modules. 
A module number of 12 is allowed only if the module name is 
N.ACXRF. 

entpoints is the hexadecimal number of entry points contained in this module. The 
last entry point of each user-supplied module is an initialization entry 
point called by SYSGEN during construction of the MPX-32 image and is 
overlaid following execution. This entry point should not be included in 

entpoints. 

Module initialization must include the system macros M.EIR, M.XIR, M.MODT, and 

M.SVCT. 
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7.6.45 /MODULES Directive 

The /MODULES directive designates the modules subsection of the //SOFTWARE 
section. If the MODULE directive is not specified, this directive is not required. 

Syntax 

/MODULES 


7.6.46 MRUN Directive 

The MRUN directive specifies the maximum number of no-wait run requests to be 
sent by a task. If this directive is not specified, the default is 5. This directive appears 
under the //SOFTWARE /PARAMETERS subsection. 

Syntax 

MRUN -num 

num is the maximum number of run requests that can be sent by a task. 

7.6.47 MSG POOL Directive 

The MSGPOOL directive specifies the number of words to reserve at SYSGEN for 
the MSG memory pool. This directive appears under the //SOFTWARE 
/PARAMETERS subsection. If this directive is specified, any message or run request 
queue (MRRQ) requests use this memory pool. Each MRRQ request corresponds to a 
message or run request sent by a task. To estimate the minimum size to request for 
MSG memory pool, calculate the average message send size or message return size 
(whichever is greater) and add 8 words for a message header. Multiply this average 
size by the estimated number of messages at any instant. The specified size is rounded 
up to a doubleword. Messages are sent from: 

• J.TSM or OPCOM to physically mount volumes 

• J.TSM to J.SSIN and back to batch tasks 

• J.TSM to J.SOUT and J.SOEX to process spooled output 


When rollover to miscellaneous memory pool occurs, a bit (C.ROLMSG) is set in the 
communications region. 
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Syntax 

MSGPOOL=n[, NOROLL] 

n is the decimal number of words to reserve. If n is not specified, the MSG 

memory pool is not reserved and the memory pool that is specified by the 
POOL directive handles all MRRQ requests. 

[, NOROLL] specifies no rollover to the memory pool specified by the POOL 
directive for MRRQ requests when the MSGPOOL is full 

7.6.48 MTIM Directive 

The MTIM directive provides the number of real-time clock interrupts per second. If 
this directive is not specified, the default is 60. This directive appears under the 
//SOFTWARE /PARAMETERS subsection. 

Syntax 

M\i\\lft=number 

number is the number of real-time clock interrupts per second. 

Note: The number of time units per second is the value of NTIM divided by the 

value of MTIM. See the NTIM directive in this chapter for more 
information. 

7.6.49 NAME Directive 

The NAME directive defines static Datapool or Global Common memory partitions. 
This directive appears under the //SOFTWARE /PARTITION subsection. 

If multiple static partitions are defined within a map block, only one partition can be 
included in the task’s logical address space at a given time. One NAME directive is 
required for each memory partition desired. 

Syntax 

NAME =nanre,SIZE=rtp,STRTPG=ip,MAP=pw 

name is the 1- to 8-character partition name 

np is the decimal number of 512-word protection granules for the partition 

sp is the logical hexadecimal starting protection granule for the partition 

pm is the starting physical decimal map block number. A map block is 2KW. 
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7.6.50 NOANSI Directive 

The NOANSI directive excludes support for ANSI labeled tapes from the system 
image. This directive appears under the //SOFTWARE /OVERRIDE subsection. 

Syntax 

NOANSI 

7.6.51 NOBASE Directive 

The NOBASE directive excludes support in H.EXEC, H.IP00, H.IP04, H.IPOF, and 
H.TAMM for the execution of tasks utilizing base mode addressing from the system 
image. This directive appears under the //SOFTWARE /OVERRIDE subsection. 

Syntax 

NOBASE 

7.6.52 NOCMS Directive 

The NOCMS directive automatically excludes support for MPX-Ijt compatibility 
mode services (modules H.ALOC, H.FISE, H.MONS, and H.CALM) from the system 
image. Software that calls a removed compatibility mode system module is aborted 
with an SV09 abort code. Do not include this directive in the SYSGEN file if you 
plan to use compatibility mode services. 

This directive appears under the //SOFTWARE /OVERRIDE subsection. 

Syntax 

NOCMS 

7.6.53 NODEMAND Directive 

The NODEMAND directive indicates demand page processing is not allowed. 

Demand page processing is supported when the mapped out object file is assigned at 
SYSGEN execution. If other than the mapped out object file is assigned, demand 
page is not supported, and this directive is ignored. 

If specified, this directive appears under the //SOFTWARE /PARAMETERS 
subsection. 

Syntax 

NODEMAND 
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7.6.54 NOLACC Directive 

The NOLACC directive overrides the MPX-32 default option of tracking last date, 
time, and owner name of access to task level resources. This directive, if specified, 
appears under the //SOFTWARE /OVERRIDE subsection. 

Syntax 

NOLACC 

7.6.55 NOMAPOUT Directive 

The NOMAPOUT directive designates that the default execution mode for all tasks 
cataloged with the ENVIRONMENT keyword SYSMAP is executed with MPX-32 
mapped into the task’s address space. If neither the MAPOUT nor NOMAPOUT 
directive is specified the compatible or NOMAPOUT mode is the default. 

If both MAPOUT and NOMAPOUT are spectified, a ***CONFLICTING 
OPTIONS error is generated by SYSGEN. If this error occurs, SYSGEN aborts and 
no image is produced. 

This directive appears under the //SOFTWARE /PARAMETERS subsection. 

Syntax 

NOMAPOUT 

7.6.56 NOSYSVOL Directive 

The NOSYSVOL directive prevents mounting and use of the system volume. Use 
this directive only when the system is to be configured with no system volume. It is 
for use with 3.0 or later revisions of Reflective Memory System Software (RMSS). 
This directive forces NOCMS. 

This directive appears under the //SOFTWARE /OVERRIDE subsection. 

Syntax 

NOSYSVOL 

7.6.57 NOTDEF Directive 

The NOTDEF directive excludes support for the TERMDEF facility from the system 
image. This directive appears under the //SOFTWARE /OVERRIDE subsection. 

Syntax 

NOTDEF 
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7.6.58 NOTSMEXIT Directive 

The NOTSMEXIT directive keeps TSM active even though it is not in use. This is 
the default directive. If specified, it appears under the //SOFTWARE 
/PARAMETERS subsection. To enable exit of TSM when inactive, see the 
TSMEXIT Directive. 

Syntax 

NOTSMEXIT 

7.6.59 NTIM Directive 

The NTIM directive provides the number of real-time clock interrupts per time unit. 

If this directive is not specified, the default is 60. This directive appears under the 
//SOFTWARE /PARAMETERS subsection. 

Syntax 

HT\M\=.number 

number is the number of clock interrupts per time unit. 

Note: The number of time units per second is the value of NTIM divided by the 

value of MTIM. See the MTIM directive in this chapter for more 
information. 

7.6.60 OTHERS Directive 

The OTHERS directive specifies access rights allowed to users who are not the owner 
or members of the project group associated with a partition previously defined with a 
NAME directive. If more than one NAME directive has been specified, the OTHERS 
directive only applies to the last one specified. If this directive is not specified, 
default is OTHERS=(R). 

If both read and write access are desired, a comma must be used as a delimiter, for 
example, OTHERS=(R,W). 

The OTHERS directive must always be specified last when OWNER and/or 
PROJECT directives are also specified. The order is OWNER, PROJECT, OTHERS. 

This directive appears under the //SOFTWARE /PARTITION subsection. 
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Syntax 

OTHERS=( [R] [,W] [,N] ) 

R specifies read access is allowed 

W specifies write access is allowed 

N specifies no access is allowed 

7.6.61 /OVERRIDE Directive 

The /OVERRIDE directive designates the override subsection of the //SOFTWARE 
section. This directive is required only if one or more directives belonging under the 
/OVERRIDE subsection is specified. 

Syntax 

/OVERRIDE 

7.6.62 OWNER Directive 

The OWNER directive specifies the owner name and associated access rights that 
apply to the partition previously defined in a NAME directive. If more than one 
NAME directive has been specified, the OWNER directive only applies to the last one 
specified. If this directive is not specified, default is OWNER=(SYSTEM,R,W). 

This directive appears under the //SOFTWARE /PARTITION subsection. 

Syntax 

0\NUER=(name 

name 

R 
W 
N 


[,R] [,W] [,N] ) 

is the I- to 8-character owner name to be associated with the partition 
specifies read access is allowed 
specifies write access is allowed 
specifies no access is allowed 
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7.6.63 OWNERNAME Directive 

The OWNERNAME directive prevents the characters of the user’s owner name from 
echoing to the terminal screen as the user logs on. If OWNERNAME=NOECHO is 
specified, no terminals will echo the owner name. If OWNERNAME=ECHO is 
specified or if the OWNERNAME directive is not included in the SYSGEN file, all 
terminals will echo the owner name. 

This directive appears under the //SOFTWARE /SECURITY subsection. 

Syntax 

OWNERNAME={ NOECHO I ECHO} 

NOECHO J.TSM inhibits echoing of owner names on all terminals including the 
system console 

ECHO J.TSM allows echoing of owner names on all terminals including the 
system console. This is the default. 

7.6.64 /PARAMETERS Directive 

The /PARAMETERS directive designates the beginning of the parameters subsection 
of the //HARDWARE and //SOFTWARE sections. This directive is required and it 
must be the first subsection of the //HARDWARE and //SOFTWARE sections. 

Syntax 

/PARAMETERS 

7.6.65 /PARTITION Directive 

The /PARTITION directive designates the memory partition and/or global common 
subsection of the //SOFTWARE section. This directive is required only if one or 
more partition directives is specified. 

Syntax 

/PARTITION 

7.6.66 PASSWORD Directive 

The PASSWORD directive specifies that passwords are required to logon to MPX-32. 
This directive appears under the //SOFTWARE /SECURITY subsection. 

Syntax 

PASSWORD 


7-44 


System Generation (SYSGEN) 



SYSGEN Directives 


7.6.67 PATCH Directive 

The PATCH directive specifies a system patch area to append to the MPX-32 resident 
image. This directive appears under the //SOFTWARE /PARAMETERS subsection. 
If this directive is not specified, a system patch area is not reserved. 

Syntax 

PATCHs/i umber 

number specifies the hexadecimal number of bytes to be added to the resident 
MPX-32 system as a system patch area. If the extended mode was 
activated at SYSGEN this specifies the hexadecimal number of bytes to 
be added in the first 16KW of memory. 

Note: The system patch area is restricted by SYSGEN to the first 16KW of 

memory. SYSGEN also restricts the area from exceeding the first 16KW of 
memory. 

7.6.68 PCHFILE Directive 

The PCHFILE directive names the permanent file which the generated system uses as 
its patch file. SYSGEN does not create the file; it must be supplied if patches are to 
be generated. If this directive is not specified, the default is M.PATCH. 

This directive appears under the //SOFTWARE /PARAMETERS subsection. 

Syntax 

PCHPWJE-filename 

filename is the 1- to 8-character ASCII file name of the file to contain patches for 
the generated system. 

7.6.69 POD Directive 

The POD directive specifies the system punched output (SPO) device to use as the 
default device for SBO. This directive appears under the //HARDWARE /SYSDEVS 
subsection. 

Syntax 

POD-devmnc 

devmnc is the 2-character device mnemonic (see Table 7-1), the 2-digit 
hexadecimal channel number, and the 2-digit hexadecimal device 
subaddress. 
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7.6.70 POOL Directive 

The POOL directive specifies the size in words of the memory pool to be reserved at 
SYSGEN time. The specified size of the memory pool is rounded up to the end of the 
current map block. If this directive is not specified, then 1000 words are reserved for 
the memory pool. 

This directive appears under the //SOFTWARE /PARAMETERS subsection. 

If the IOQPOOL and MSGPOOL directives are not specified, the memory pool 
requested by the POOL directive is the only memory pool. This memory pool is then 
used for all requests. 

If the IOQPOOL and/or MSGPOOL directive is specified, the total memory pool size 
is the memory pool plus the IOQ memory pool and/or the MSG memory pool. This 
total is then rounded up one map block boundary. 

The memory pool requested by the POOL directive is then used for miscellaneous 
requests (requests other than IOQ or MRRQ requests). 

This memory pool is also used when there is no space available in the IOQ memory 
pool or the MSG memory pool, provided NOROLL was not specified for the IOQ or 
MSG memory pool. 

Syntax 

POO\-=words 

words is the decimal number of words to be reserved. 

7.6.71 PRIORITY Directive 

' The PRIORITY directive specifies the interrupt configuration and interrupt processors 
to use for the target system. The interrupt processors provided are: Attention (H.IP13), 
Real-time Clock (H.IPCL), and CPU Interval Timer (H.IPIT). The CPU Interval 
Timer is directly connected to the lowest interrupt priority level in the system. If a 
machine directive is not specified, the lowest interrupt level is 6F. 

This directive appears under the //HARDWARE /INTERRUPTS subsection. 

If an IPU is SYSGENed into the system, an IPU accounting processor (H.EPUIT) is 
available. This processor is directly connected to the IPU accounting interval timer at 
any priority. The lowest available priority is recommended. 

I/O channel interrupt levels on a CONCEPT/32 are 04 to 13. 

Syntax 

PRIORITY=//jr/cv, RJOM=(channel,subaddress) [,PROGRAM=«amc] [,INTV] 
intlev is the 2-digit hexadecimal interrupt level. The lowest level is 6F. 
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channel is the 2-digit hexadecimal RTOM board or IOP RTOM function channel 
address 

subaddress is the 2-digit hexadecimal RTOM board or IOP RTOM function 
subaddress, which is the one’s complement of the RTOM relative 
physical priority for the interrupt level. 

[,PROGRAM=n<2wie] 

is the 1- to 8-character name of the program located in the file assigned to 
LFC OBJ. If the program is to be directly connected to this interrupt 
level and SYSGENed with the resident operating system, the name must 
be supplied. If tasks are to be indirectly connected to the interrupt level, 
no program name should be supplied. An indirectly connected task 
linkage block (ITLB) is defined using the ITLB directive. 

[,INTV] indicates the level is an RTOM interval timer. A device entry, whose 
address is equal to the interrupt priority level, is being built in the 
scratchpad. 

7.6.72 PROGRAM Directive 

The PROGRAM directive specifies the program names of the trap processors to be 
configured on the resident system. This directive appears under the //HARDWARE 
/TRAPS subsection. 

If this directive is specified, no defaults are in effect and all trap handlers to be 
included on the system must be listed. If it is not specified, the following defaults are 
used: 

H.IPOO H.IP09 
H.EPAS H.IPOC 
H.EP02 H.IPOF 
H.EP03 H.IP10 
H.IP04 H.IP13 
H.EP05 H.IPHT 
H.IP06 H.IPU 

H.IP07 H.IPUAS (if an IPU is configured) 

H.IP08 H.CPU 

If the defaults are required along with other optional system modules, the 
USERPROG directive should be used instead of the PROGRAM directive. 
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Syntax 

PROGRAM^ ( namel , . . . name 7) 

namel ...name7 

are 1- to 8-character ASCII program names of the trap handlers assigned 
to LFC OBJ, separated by commas. A maximum of 7 names can be 
entered per directive. 

Note: Do not include H.CPU2 or H.EXEC2 in this directive, because the DELTA 

directive automatically selects them. 

7.6.73 PROJECT Directive 

The PROJECT directive specifies the project group name and associated access rights 
which apply to the partition previously defined with a NAME directive. If more than 
one NAME directive has been specified, the PROJECT directive only applies to the 
last one specified. This directive is optional. If not specified, the default is PROJECT= 
(SYSTEM, R,W). 

The OWNER directive must precede PROJECT and OTHERS directives if specified. 
The order is OWNER, PROJECT, OTHERS. 

This directive appears under the //SOFTWARE /PARTITION subsection. 

Syntax 

PRO J ECT -(name [,R] [,W] [,N] ) 

name is the 1- to 8-character project group name associated with the partition 
R specifies read access is allowed 

W specifies write access is allowed 

N specifies no access is allowed 

7.6.74 RLWU Directive 

The RLWU directive specifies whether read/lock write/unlock applies to all memory, 
or only uncached ranges. This directive should be specified only once. Additional 
RLWU directives are ignored. If this directive is not specified, read/lock write/unlock 
applies only to uncached ranges. This directive appears under the //HARDWARE 
/MEMORY subsection. 

Syntax 

RLWU={ YIN) 

Y specifies that read/lock write/unlock (RLWU) is employed over all 

memory when memory has the read/lock attribute 

N specifies that RLWU is not employed over all memory. RLWU still 

applies to uncached ranges. 
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7.6.75 /RMSTABLS Directive 

The /RMSTABLS directive designates the Resource Management System Tables 
subsection of the //SOFTWARE section. This directive is required if the ARTSIZE 
directive is specified. 

Syntax 

/RMSTABLS 

7.6.76 RMTSiZE Directive 

The RMTSIZE directive increases the number of bytes per entry in the Resourcemark 
Table. If this directive is not specified, the default is 0. This directive appears under 
the //SOFTWARE /PARAMETERS subsection. 

Syntax 

RMTSIZE =num 

num is a decimal number between 64 and 1000. 

7.6.77 SAPASSWD Directive 

The SAPASSWD directive disables the PASSWORD task so that only the system 
administrator can change a password. This directive appears under the //SOFTWARE 
/SECURITY subsection. 

Syntax 

SAPASSWD 

7.6.78 /SECURITY Directive 

The /SECURITY directive designates the security subsection of the //SOFTWARE 
section. This directive is required only if one or more security directives is specified. 

Syntax 

/SECURITY 
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7.6.79 SEQUENCE Directive 

The SEQUENCE directive names load modules to be activated in a sequential manner 
by SYSINIT immediately after the target system is booted. Tasks activated with this 
directive must complete and exit before the next task is activated. 

The system console cannot be used as a TSM terminal until all specified tasks are 
complete. 

SYSINIT checks the completion status of each task as it exits and displays a message 
on the system console if abnormal status was returned. A maximum of 70 bytes of 
call back information (in ASCII) can be sent using the receiver exit block (RXB) 
when exiting a run receiver task. This information, if present, is displayed by 
SYSINIT on the system console. The user status byte, if not zero, is also displayed in 
decimal on the system console. 

If control switch 5 is set before booting the system, task names listed in the 
SEQUENCE directive will not be activated as part of the target system boot (load) 
process. 

This directive appears under the //SOFTWARE /PARAMETERS subsection. 

Syntax 

SEQUENCE=(fltfme/,.../uwje7) 

namel ,...name7 

are the 1- to 8-character ASCII load module names to be activated, 
separated by commas. A maximum of 7 names can be entered per 
directive. 

7.6.80 SGOSIZE Directive 

The SGOSIZE directive is included for compatibility only. This directive is accepted 
by SYSGEN, but the results are not used in job processing. This directive appears 
under the //SOFTWARE /FILES subsection. 

Syntax 

SGOSIZE=WocL$ 

blocks is the number of 192-word blocks of disk space to be allocated for each 
SGO file 
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7.6.81 SHARE Directive 

The SHARE directive specifies the number of entries in the shared memory table 
(SMT). Each entry defines a shared memory area; for example, CSECT, Global 
Common, Datapool, or Shared Image. A minimum of 2 entries must be specified to 
use the Text Editor and Volume Manager. If this directive is not specified, the default 
for non-extended and mapped out images is one SMT entry for the .MPXTBLS 
partition. The default for an extended MPX-32 images is two SMT entries, for the 
.extdmpx and .MPXTBLS partitions. 

SYSGEN automatically increments C.SMTN for these partitions. 

This directive appears under the //SOFTWARE /TABLES subsection. 

Syntax 

SHARE=«Mw6er 

number is the number of entries in the shared memory table. It must be sufficient 
to define all static and dynamic partitions. 

7.6.82 SID Directive 

The SID directive specifies a system input device (SED) to use as the default device in 
related OPCOM commands. This directive appears under the //HARDWARE 
/SYSDEVS subsection. 

Syntax 

SID -devmnc [,DENSITY=rfe«s/ry] [,PARITY=pariry] 

devmnc is the 2-character device mnemonic (see Table 7-1), the 2-digit 

hexadecimal channel number, and the 2-digit hexadecimal device 
subaddress. 

[,DENSITY=<7mWry] 

is used only for 7-track magnetic tape. H is for high density. L is for low 
density. 

[,PARITY=par/ry] 

is used only for 7-track magnetic tape. E for even parity. O for odd parity. 


7.6.83 SIZE Directive 

The SIZE directive specifies the memory configuration of the target system. This 
directive is required. The SIZE directive appears under the //HARDWARE 
/MEMORY subsection. 

Using multiple SIZE directives, memory types must be specified in order of 
configuration in memory; that is, from low address to high address. 


MPX-32 Reference Volume III 


7-51 



SYSGEN Directives 


The SIZE directive now has a second syntax which is preferred to the original syntax. 
This new syntax allows the user to mix (MS) 2 and RMS shared memory and to 
restrict the allocation of multiprocessor shared memory to only those tasks that 
physically request it. The original SIZE directive syntax is still accepted. 


7.6.83.1 Preferred SIZE Directive Syntax 
Syntax 

SIZE ^blocks , TYPE=mew [.RESERVED] [, SHARED={NIY [, INIT= {YIN}] 
[,RMS=artar]}] [,CACHE={YIN]] 

SiZE=blocks 

blocks is the memory size in decimal number of map blocks. Maximum 
value is 2048. 

TYPE -mem 

mem is a memory type from the list below. E, H, and S are memory types 
that a nonbase task can request with the Catalog ENVIRONMENT 
directive. 


Type 

Description 

D 

SelBUS (DRAM) memory (CONCEPT 32/2000 only. 
See note 4.) 

E 

task delays until E class is available 

H 

task delays until H or E class is available 

S 

task delays until S, H, or E class is available 

N 

indicates absent memory 

HI 

is CPU shadow memory 

H2 

is IPU shadow memory 

H3 

is CPU and IPU shadow memory 


[.RESERVED ] 

reserves shadow memory for requesting tasks. This option is valid only 
with types HI, H2, and H3. 

[,SHARED={NIY}] 

N specifies that multiprocessor memory is allocated to any task. Y 
specifies it is allocated only to tasks requesting physical memory for 
shared images or static partitions. N is the default. 

[,INIT={ YIN}] 

N specifies that the memory is not initialized at system startup. Y 
specifies to initialize shared memory at system startup. Y is the default. 

[,RMS=£teWr ] 

addr is the hexadecimal address of the Reflective Memory System (RMS) 
control registers 

[,CACHE={ YIN}] 

N specifies that memory is uncached. Y specifies that memory is cached. 
Y is the default. 
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This is a multiprocessor shared memory example for two systems with 2MB of 
multi-processor shared memory and 4MB of non-shared memory. The two systems are 
to share 128KW of memory. The balance of the 2MB is divided for use by die two 
systems. 

System 1: 

/MEMORY 

SIZE=512,TYPE=S 

SIZE=64,TYPE=S, SHARED=Y, INIT=N, CACHE=N 
SIZE=112, TYPE=S, SHARED=Y, INIT=N, CACHE=N 

SIZE=80, TYPE=N, SHARED =Y, INIT=N, CACHE=N 


4MB OF NON-SHARED 
MEMORY 

128KW TO BE SHARED 
224KW TO BE USED BY 
SYSTEM 1 

160KW TO BE USED BY 
SYSTEM 2 


/PARTITION 

NAME=GLOBAL01, SIZE=256, STRTPG=100, MAP=512 


System 2: 

/MEMORY 

SIZE=512,TYPE=S 

SIZE=64, TYPE=S, SHARED=Y, INIT=N, CACHE=N 
SIZE=112, TYPE=N, SHARED=Y, INIT=N, CACHE=N 

SIZE=80 , TYPE=S, SHARED=Y, INIT=N, CACHE=N 


MEMORY 

128KW TO BE SHARED 
224KW TO BE USED BY 
SYSTEM 1 

160KW TO BE USED BY 
SYSTEM 2 


/PARTITION 

NAME=GLOBAL01,SIZE=256, STRTPG=100 ,MAP=512 
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Notes: 

1. SYSGEN memory directives must reflect the hardware cache configuration of the 
target machine. 

• On a 32/87 or 32/97 processor, the SYSGEN directives for uncaching should 
match the memory configuration of CPU board C. 

• On a 32/67 or CMOS processor, the hardware cache configuration is software 
controllable with the RLWU directive and the SIZE directive CACHE option 
if the memory has the proper attributes. If memory is not cache coherent, 
CACHE=N must be specified. 

2. The CACHE=N option uncaches a physically contiguous range of memory on 
half-megabyte boundaries in half-megabyte increments. This range is bounded 
by the highest and lowest map blocks of contiguous ranges resulting from 
multiple SIZE directives. The lower bound is set at the first specification of the 
CACHE=N option and the higher bound is set at the last CACHE=N. All 
memory between these bounds is uncached and the range is ended by the first 
CACHE=Y. After this, no other CACHE=N can be specified. The CACHE 
option must reflect the physical attributes of the configured memory. Memory 
used as non-cache coherent must be specified as CACHE=N. 

2 

3. The SHARED option should be used when (MS) or reflective memory is shared 
among processors. When (MS) 2 memory is shared, ranges within physically 
shared memory can be treated independently. For example, a system can be 
SYSGENed with range A shared by several processors and range B treated as 
nonshared. To do this, range A is specified as SHARED=Y on all processors and 
should be initialized at system startup by only one processor. Range B is 
specified as SHARED=N on the processor using it and as nonpresent (TYPE=N) 
on the other processors. Range B should be initialized at system startup by the 
processor using it. 

4. Memory types E, H, and S must reside in SRAM memory. Type D memory 
must reside in DRAM. Type D memory is only valid for the CONCEPT 
32/2000 processors. If DRAM is declared on any processor other than the 
CONCEPT 32/2000, it remains defined as type D memory. The restrictions for 
DRAM on a CONCEPT 32/2000 apply to DRAM on other processors. 

Once type D memory is defined, no more definitions of E, H, or S are valid. If 
E, H, or S memory follows the definition of D memory, the following error 
message is generated and no image is produced: 

***TYPE=E, H OR S IS NOT VALID AFTER TYPE=D 

5. HI , H2, and H3 are not valid for the CONCEPT 32/2000. If defined on a 
32/2000, shadow memory defaults to type H. 
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7.6.83.2 Original SIZE Directive Syntax 
Syntax 

SIZE=/m,TYPE=c ,CLASS=x [ [.RESERVED] [.MULTI ] [,MS2] ] 


nn is the size in decimal number of map blocks for phyical memory or the 

number of pages for memory partitions. Maximum value is 2048. 

c is memory type D, E, H, S, N, HI, H2, or H3. E, H, and S are memory 

types as described in Volume I. Absent memory is indicated by N. HI, 
H2, and H3 are shadow memory types. D is DRAM memory (CONCEPT 
32/2000 only). 


x is memory class C or S: 

C is core memory 

S is semiconductor memory 

[.RESERVED] 

reserves shadow memory for requesting tasks. Valid only with types HI, 
H2, or H3. 


[.MULTI] specifies the multiprocessor memory flag is set indicating this memory is 
not to be initialized during the startup procedure. This memory is to be 
uncached and have read/lock, write/unlock employed in the uncached 
range. It will not be initialized. 


[,MS2] identifies the shared memory configured as Multiprocessor Shared 

Memory System (MS) 2 rather than the MB C/MB A Multiport Memory 
System. Multiprocessor Shared Memory System (MS) 2 is required for any 
dual-ported memory disk. This memory is to be cached and have 
read/lock, write/unlock employed. It will not be initialized. If MS2 is 
used, the MULTI option must also be specified. 


This is a multiprocessor shared memory example for two systems with 2MB of 
multi-processor shared memory and 4MB of non-shared memory. The two systems are 
to share 128KW of memory. The balance of the 2MB is divided for use by the two 
systems. 
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System 1: 

/MEMORY 

SIZE=512, TYPE=S,CLASS=S 

SIZE=64, TYPE=S, CLASS=S, MULTI 
SIZE=112,TYPE=S,CLASS=S, MULTI 

SIZE=80,TYPE=N,CLASS=S, MULTI 


4MB OF NON-SHARED 
MEMORY 

128KW TO BE SHARED 
224KW TO BE USED BY 
SYSTEM 1 

160KW TO BE USED BY 
SYSTEM 2 


/PARTITION 

NAME=GLOBAL01,SIZE=256,STRTPG=100,MAP=512 


System 2: 

/MEMORY 

SIZE=512,TYPE=S,CLASS=S 

SIZE=64 , TYPE=S , CLASS=S , MULTI 
SIZE=112, TYPE=N, CLASS=S , MULTI 

SIZE=80,TYPE=S,CLASS=S, MULTI 


4MB OF NON-SHARED 
MEMORY 


128KW TO 
224KW TO 
SYSTEM 1 
160KW TO 
SYSTEM 2 


BE 

SHARED 

BE 

USED 

BY 

BE 

USED 

BY 


/PARTITION 

NAME=GLOBAL01 , S IZE=2 5 6 , STRTPG=1 0 0 , MAP=5 12 


7.6.83.3 Shadow Memory Error Messages 

If shadow memory is not configured properly, the following SYSGEN directive error 
message is displayed: 

*** SHADOW MEMORY CONFIGURATION VIOLATION 

If RESERVED is used with nonshadow memory types, the following SYSGEN 
directive error message is displayed: 

*** ONLY SHADOW MEMORY CAN BE RESERVED 

For more information on shadow memory, refer to Chapter 10 of this volume. 
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7.6.83.4 Shared Memory Error Messages 

Note: A system can have only one type of shared memory configured. 

If CACHE=N is specified for a second region of contiguous memory, the following 
message is displayed and SYSGEN aborts: 

*** ONLY ONE CONTIGUOUS UNCACHED REGION ALLOWED 

If INIT or RMS options are used without SHARED=Y, the following message is 
displayed and SYSGEN aborts: 

*** INVALID KEYWORD WHEN S HARED =Y NOT SPECIFIED 

If a SYSGEN SIZE directive specifies the MULTI option for memory discontiguous 
with a previous MULTI specification, SYSGEN generates a SG40 error and the 
following message is displayed: 

WARNING; A CONTIGUOUS MEMORY RANGE WILL BE UNCACHED 

7.6.84 SMD Directive 

The SMD directive is included for compatibility and is ignored by SYSGEN. Items 
following this directive on the same line are ignored. 

Syntax 

SMD 

7.6.85 //SOFTWARE Directive 

The //SOFTWARE directive indicates the beginning of the software configuration 
section of directives. This directive is required. 

Syntax 

//SOFTWARE 
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7.6.86 SVC Directive 

The SVC directive increases the size of the SVC type 1 table. If this directive is not 
specified, the default size is 7F. This directive appears under the //SOFTWARE 
/PARAMETERS subsection. 

Syntax 

SVC=num 

num is the hexadecimal number, X’80’ through X’FF’ of entries allowed in the 

SVC type 1 table. 

7.6.87 SWAPDEV Directive 

The SWAPDEV directive specifies the default swap device. When an IPL or restart is 
performed, the default swap device is automatically assigned as the device on which 
the swap volume is mounted. This directive appears under the //HARDWARE 
/SYSDEVS subsection. 

If the SWAPDEV directive is not specified, the system volume is the default swap 
volume. 

Syntax 

SWAPDEV={devw/ic I IPLDEV} 

devmnc is the 2-character device mnemonic, the 2-digit hexadecimal channel 

number, and the 2-digit hexadecimal device subaddress of the device to be 
assigned as the swap device 

IPLDEV specifies the system volume as the swap volume 

Specifying SWAPDEV=devmflc causes H.SINIT to mount the swap volume on the 
specified device dining IPL or restart. If any errors occur while H.SINIT is mounting 
the swap device, they are handled according to whether the SYSGEN directive 
MODE=SNOP has been specified. (See the MODE Directive section of this chapter 
for more information.) If MODE=SNOP has been specified, H.SINIT will report 
mounting errors to the system console and make the system volume the swap volume. 
If MODE=SNOP has not been specified, an error message will be displayed on the 
system console and H.SINIT will prompt the user with the following: 

ENTER SWAP DEVICE CHANNEL AND SUBADDRESS 
(OR <CR> IF SYSTEM VOLUME) : 

Specifying SWAPDEV=IPLDEV causes H.SINIT to make the system volume the 
swap volume. If an error occurs while H.SINIT is mounting the system volume, 
H.SINIT will abort. 


7-58 


System Generation (SYSGEN) 



SYSGEN Directives 


If the SWAPDEV directive is not supplied in the SYSGEN directive file, H.SINIT 
will issue the following prompt during IPL or restart, unless the MODE=SNOP has 
been specified: 

ENTER SWAP DEVICE CHANNEL AND SUBADDRESS 
(OR <CR> IF SYSTEM VOLUME) : 

This prompt will appear again if any error occurs while H.SINIT is mounting the 
swap volume. 

If MODE=SNOP has been specified, H.SINIT will make the system volume the swap 
volume without issuing a prompt. 

7.6.88 SWAPLIM Directive 

The SWAPLIM directive specifies the minimum partial swap quantum. This directive 
appears under the //SOFTWARE /PARAMETERS subsection. If this directive is not 
specified or if 0 is specified for n, and if memory allows, swapper swaps on demand 
one map block at a time. If a number greater than 0 is supplied for n, swapper swaps 
out n map blocks of the task or the entire task, whichever is smaller. To achieve total 
task swapping for a 32/87 n must be at least 128. To achieve total task swapping for 
a 32/67 or a 32/97 use 2048 for n. The value specified is dependent on system use. 
When heavy swapping is anticipated and small tasks are running, a value between 7 
and 15 is recommended. 

Syntax 

SWAPLIM=« 

n is the minimum partial swap quantum in map blocks 

7.6.89 SWAPSIZE Directive 

The SWAPSIZE directive specifies the initial swap file size. If this directive is not 
specified, the default is 2 times the configured memory. If 0 is specified, swapping is 
inhibited. This directive appears under the //SOFTWARE /PARAMETERS 
subsection. 

Syntax 

SWAPSIZE=s/ze 

size is the initial swap file size in megabytes 
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7.6.90 SWP Directive 

The SWP directive is included for compatibility and is ignored by SYSGEN. Items 
following this directive on the same line are ignored. 

Syntax 

SWP 

7.6.91 SYCSIZE Directive 

The SYCSIZE directive is included for compatibility only. This directive is accepted 
by SYSGEN, but the results are not used in job processing. Default is 100 blocks. 
**.BB This directive appears under the //SOFTWARE /FILES subsection. 

Syntax 

S Y OS\ZE-blocks 

blocks is the number of 192-word blocks of disk space to be allocated for each 
SYC file 

7.6.92 SYMTAB Directive 

The SYMTAB directive names the permanent file where the symbol table of the 
generated system is written. If the file does not currently exist, SYSGEN creates the 
file. This directive is required. It appears under the //SOFTWARE /PARAMETERS 
subsection. 

Syntax 

SYMT AB=file name 

filename is the 1- to 8-character ASCII file name of the system symbol table file 

7.6.93 /SYSDEVS Directive 

The /SYSDEVS directive designates the system device subsection of the 
//HARDWARE section. This directive is required. 

Syntax 

/SYSDEVS 
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7.6.94 SYSMOD Directive 

The SYSMOD directive replaces system modules with other modules or removes the 
compatibilty mode system modules H.ALOC, H.FISE, H.MONS, and H.CALM. One 
SYSMOD directive is required for each system module to be replaced. 

This directive appears under the //SOFTWARE /OVERRIDE subsection. 

Syntax 

SYSMOD=«ame/ , R EPMOD=/j<2me2 

namel is the 1- to 8-character ASCII name of the system module to be replaced 
or removed 

name2 is the 1- to 8-character ASCII name of the replacement module or NULL 

7.6.95 SYSONLY Directive 

The SYSONLY directive specifies SYSTEM as the only valid ownemame. This 
directive appears under the //SOFTWARE /SECURITY subsection. If an M.KEY file 
exists, this directive is ignored. For more information, refer to Chapter 10, the System 
Administrator Services chapter, in this volume. 

Syntax 

SYSONLY 

7.6.96 SYSTEM Directive 

The SYSTEM directive names the permanent file where the generated system is 
written. If the file does not currently exist, SYSGEN creates the file as a system file. 

This directive is required. It appears under the //SOFTWARE /PARAMETERS 
subsection. 

Syntax 

SYSTEM=sys/i/e 

sysfile is the 1- to 8-character name of the file to contain the resident system 

image generated at SYSGEN. This file name must not be the same as the 
name of the current default image. 
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7.6.97 SYSTRAP Directive 

The SYSTRAP directive selectively overrides any of the default trap handlers listed 
under the PROGRAM directive. This directive appears under the //HARDWARE 
/TRAPS subsection. 

The SYSTRAP directive cannot be used if a PROGRAM directive is used. 

Syntax 

SYSTRAPs«a/Me/,REPTRAP=«<jme2 

namel is the default trap handler name to be overridden (e.g., H.IP10) 

name2 is the 1- to 8-character ASCII program name assigned to LFC OBJ used 

in place of namel 

7.6.98 /TABLES Directive 

The /TABLES directive designates the tables subsection of the //SOFTWARE 
directives. This directive is required. 

Syntax 

/TABLES 


7.6.99 TERMPRI Directive 

The TERMPRI directive specifies the execution priority level for all tasks activated in 
the interactive terminal environment. If this directive is not specified, the default is 
.priority 60. This directive appears under the //SOFTWARE /PARAMETERS 
subsection. 

Syntax 

TERMPRI=/m 

nn is the 2-digit decimal time-distribution priority level, 55 to 64, for 

interactive processing. 

7.6.100 TIMER Directive 

The TIMER directive specifies the number of timer table entries to be generated in the 
MPX-32 resident image. If this directive is not specified, the default value is 0. This 
directive appears under the //SOFTWARE /TABLES subsection. 
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Syntax 

TIM ER-number 

number is the number of timer table entries to be generated 

7.6.101 TITLE Directive 

The TITLE directive attaches identifying information to the SYSGEN listed output. If 
this directive is specified, it must be the first directive in the directive stream. 


Syntax 

T\TLE=data 

data is 1 to 66 ASCII characters of information 

7.6.102 TQFULL Directive 

The TQFULL directive specifies the maximum time quantum that a time-distribution 
task can acquire prior to preemption by another time-distribution task at the same 
priority level. This directive appears under the //SOFTWARE /PARAMETERS 
subsection. If TQFULL or TQMIN is supplied, then both are required. TQFULL 
must be greater than TQMIN. If not specified, TQFULL defaults to 600 milliseconds. 

Syntax 

TQFULL -time 

time is the maximum number of milliseconds in the quantum 

7.6.103 TQMIN Directive 

The TQMIN directive specifies the minimum time quantum that a time-distribution 
task can acquire prior to preemption by another time-distribution task at a higher 
priority level. This directive appears under the //SOFTWARE /PARAMETERS 
subsection. If TQMIN or TQFULL is supplied, then both are required. TQMIN must 
be less than TQFULL. If not specified, TQMIN defaults to 200 milliseconds. 

Syntax 

TQMIN -time 

time is the minimum number of milliseconds in the time quantum 
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7.6.104 TRACE Directive 

The TRACE directive initializes the system trace flag word C.TRACE. This directive 
appears under the //SOFTWARE /PARAMETERS subsection. Bit indicators within 
C.TRACE are described in the MPX-32 Technical Manual, Volume I, Chapter 6. 

If this directive is not specified, C.TRACE defaults to X’FFFFFFFE’. 


Syntax 

TRACE -num 

num is a 1- to 8-character hexadecimal number 

If the TRACE directive is specified, the following NAME directive must be specified 
under the //SOFTWARE /PARTITION subsection: 

NAME=«amc, SIZE=16,STRTPG=3EF,MAP=60 

name 'll the 1- to 8- character user-specified name of the trace partition 


7.6.105 /TRAPS Directive 

The /TRAPS directive designates the trap descriptor subsection of the //HARDWARE 
section. This directive is required. 


Syntax 

/TRAPS 

7.6.106 TSMEXIT Directive 

The TSMEXIT directive allows TSM to exit from the system when it is no longer 
required. TSM will be reactivated when one of the following occurs: 

• a wake up character is entered 

• a task performs an M.BATCH 

• a task performs an M.DEFT 

If this directive is specified, it appears under the //SOFTWARE /PARAMETERS 
subsection. 

To disable exit of TSM, see the NOTSMEXIT Directive. 

Syntax 

TSMEXIT 
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7.6.107 USERPROG Directive 

The USERPROG directive specifies system modules to be included in the system 
along with the default trap handlers or those specified in the PROGRAM directive. 
This directive is required to include the H.ADA module. This directive appears under 
the //HARDWARE /TRAPS subsection. 

Syntax 

USERPROG=(/wj/ne7, . . . name 7) 
name 1,.. .name 7 

are 1- to 8-character ASCII program names of modules assigned to LFC 
OBJ, separated by commas. A maximum of 7 names can be entered per 
directive. 


7.6.108 /VP Directive 

The /VP directive designates the Vector Processor (VP) subsection of the 
//HARDWARE section. This directive is required for systems containing a VP3300 or 
VP6410. 


Syntax 

A/P 

7.6.109 VP Directive 

The VP directive specifies the device characteristics of the Vector Processors to be 
configured. This directive is required for systems containing a VP3300 or VP6410 VP. 
This directive appears under the //HARDWARE /VP subsection. 

Syntax 

VP= {(aa [, number]) I aa] [,PROGRAM=w£»Jw/e/] 

aa is the 2-digit hexadecimal subchannel number 

number is the number of VPs to be configured. If not specified, the default is 1. 

modulel is the name of the module used to include a VP memory partition into a 

task’s logical address space. If not specified, the default is H.ACBA. 
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7.6.110 VPID Directive 

The VPID directive specifies unit specific information for a VP. This directive is 
required for systems containing a VP3300 or VP6410. One VPID directive must be 
used for each Vector Processor specified in the VP directive. This directive appears 
under the //HARDWARE /VP subsection. 

Syntax 

VPIDstf#, VPTYPE=rr, STARTBLK=W/t, PRIORITY=mr/ev, INTRPT=(cc,m) 

[,PROGRAM=mo</K/e2] [,IPCA=ips/ze] [,BUS0=i>0ii'ze] [,BUS1=Wi/ze] 
[,BUS2=b2size] [,BUS3=W«ze] 

aa is the 2-digit hexadecimal subchannel number 

tt is the type of VP: 33 specifies a VP3300, and 64 specifies a VP6410 

blk is the decimal starting physical map block address where the VP memory 

partitions are to be allocated 

intlev is the 2-digit hexadecimal interrupt level 

cc is the RTOM/IOP channel address 

ss is the RTOM/IOP 2-digit hexadecimal interrupt subaddress 

[ , P ROG R AM=module2 ] 

module2 is the name of the interrupt handler to be used with this VP. If 
not specified, the default is H.IPVP. 

[,IPCA =ipsize] 

ipsize is the number of pages to be allocated for the Interrupt Processor 
Context. If not specified, the default is 16 pages. 

[,BUSO=MXs/ze] 

bOsize is the number of pages allocated for BUSO. If not specified, the 
default is 16 pages. This parameter is valid for VP6410 only. 

[,BUS1sWs/ze] 

blsize is the number of pages allocated for BUS1. If not specified, the 
default is 32 pages for a VP6410 and 48 pages for a VP3300. 

[,BVS2=b2size] 

b2size is the number of pages allocated for BUS2. If not specified, the 
default is no pages. This parameter is valid for VP3300 only. 

[,BUS3=bii/ze] 

b3size is the number of pages allocated for BUS3. If not specified, the 
default is no pages. This parameter is valid for VP3300 only. 
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8.1 Introduction 

The System Debugger is provided on the Master SDT. It debugs the resident 
operating system as well as SYSGENed user interrupt and I/O handlers. The 
debugger is SYSGENed as part of the resident MPX-32 starter system, and it can be 
included in any user configuration of the resident system by using the SYSGEN 
directive USERPROG=DEBUG. 

The System Debugger is composed of two parts: a small portion runs mapped as part 
of the resident operating system and occupies approximately 600 words of system 
logical address space; the remaining portion runs unmapped and represents the bulk of 
the debugger. The unmapped portion permanently occupies approximately 8KW of 
physical memory, but does not increase the size of the logical address space devoted 
to the operating system. 

The system debugger only operates in privileged mode because it is using stand-alone 
I/O. Therefore, even privileged instructions are executed. Invalid instructions are 
flagged with an asterisk immediately following the opcode text. The instructions that 
may alter the program counter in the pseudo-PSD are executed, such as LPSD, BRI, 
SVC, etc., and traced by the debugger. 

Unusual instruction sequences (branch increment with positive register contents, 
double word instructions using an odd number register, etc.) are flagged with a 
question mark following the instruction text. These inform the user of possible 
problems. 

The debugger always starts in symbolic mode to allow addressing by base name plus 
offset. The AB directive switches to absolute addressing. The SY directive switches 
back to symbolic addressing. (Absolute or symbolic modes apply to all address 
displays.) 

Each time the debugger is entered, C.GINT (the global interrupt counter) is 
incremented by 1. When the debugger is exited, C.GINT is decremented by 1. This 
defers all task scheduling during the debug session. To allow a schedule event to 
occur while debugging, use the CT directive specifying the address of the next 
instruction to be executed. 

Physical and virtual (logical) modes are maintained by the System Debugger. When 
entry into the debugger is made from an unmapped state, the physical mode is the 
default. When entry is made from a mapped state, the virtual mode is the default. 
Execution traces and pure memory references are relative to the default mode 
established on entry. Symbolic references to memory toggle the display mode to that 
of the base symbol used; however, the execution trace mode remains in the mode of 
entry. The BA directive can be used to define or redefine the attributes of any base. 
Execution tracing is not permitted within a mapped out task’s virtual address space. 
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8.2 Using the Debugger 


8.2.1 Arithmetic and Special Operators 

The debugger recognizes the following characters as unique operators allowable in any 
command or expression: 


Character 

G thru Z 
R 

parenthesis ( ) 

Colon (:) 

Asterisk (*) 

Slash (/) 

Semicolon (;) 

Question Mark (?) 
Dollar Sign ($) 

Plus Sign (+) 

Minus Sign (-) 

Asterisk (*) 

Slash (/) 

Ampersand (&) 

At-sign (@) 

Right Angle Bracket (>) 

Left Angle Bracket (<) 

Apostrophe (’) 
Backslash (\) 


Usage 

symbolic base values 
register designator 
contents of 

current value of last displayed contents 

indirect address if first character in a field 

current total 

task high address 

task low address 

current PC contents from PSD 

field on left added to field on right 

field on right subtracted from field on left 

field on left multiplied by field on right 

field on left divided by field on right 

field on left is ORed with field on right 

field on left is ANDed with field on right 

field on left is shifted right by the count 
in the right side field 

field on left is shifted left by the count in 
the right side field 

ASCII text delimiter 
subfield delimiter 
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8.2.2 Special Functions 

The debugger expects to read a 2-character directive and options; however, the 
following special functions may be input instead of the normal directives: 

Character Usage 

A display previous location 

* display location indirect to current location 

<ret> display next location 

> right shift current location and display 

< left shift current location and display 

$ display current location 

These functions require only the one byte of input. 


8.2.3 Execution Breakpoints 

A breakpoint is an address where program execution can be interrupted. Eight fixed 
breakpoints can be defined. In addition, a one-shot breakpoint can be established for 
the directed execution directives GO or CT. 
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8.2.4 Debugger Bases 

The debugger uses a range of 1 -character bases to provide symbolic references to 
memory. Once established, the base characters (characters G through Z) can be used 
in any directive or arithmetic expression. The following bases are initialized by the 
debugger when loaded with MPX-32: 


Base 

Module 

G 

H.TAMM 

H 

H.MEMM 

I 

H.EXEC 

J 

available 

K 

available 

L 

H.AJLOC 

M 

H.FISE 


N 

logical starting address of current task’s TSA 

O 

available 

P 

available 

Q 

IP06 (SVC) 

R 

H.SWAPR 

S 

X’ 78000’ (User DEBUG) 

T 

H.TSM 

U 

logical starting address of current task’s DSECT 

V 

H.VOMM 

w 

H.MONS 

X 

H.REXS 

Y 

H.IOCS 

Z 

H.REMM 

Note: 

401 is equivalent to 40+1 or 1+40. 


8.2.5 Base Characters 

The characters ’G’ through ’Z’ can be set to any value by the BA (Base) directive. 
For example, 

BA G 427F0 

defines G as location 427F0. G appears in all address displays in place of 427F0. 
G can be used in any directive and it is processed as 427F0. 

All predefined bases except N and U have the physical attribute by default; N and U 
have the virtual (logical) attribute by default. These attributes are in effect until 
redefined using the BA directive. Virtual addresses are established using the map 
registers of the current task executing within the CPU. Therefore, if no task is 
current, the virtual attribute is undefined at that instance. Extended MPX-32 module 
bases are virtual when a task is current. 
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8.2.6 Operator Restrictions 

Arithmetic expressions are evaluated left to right. 

Operators can appear in any directive and are not restricted in length. For example: 

AR D9C35FFF, 03800000, >14 
This results in a hexadecimal 18. 

AR *34595, <2, +Z, +3000 

If location 34595 contained 500 (hex) and Z was set to 30000, the above expression 
has a value of 34400. 

DM 0 + 34C2 -1>2 

The location specified by base O was previously set to 30000, so the DM location is 
CD30 (30000 + 3 4C2 -1 and right-shifted 2 bits). 

The above examples illustrate expressions that can be used in any appropriate 
directive. 

8.2.7 Expressions 

The debugger processes expressions from left to right. For example, 

AR 2*32+G/2 

breaks down to 2 times 32 plus the value of G. That total is divided by 2 and the 
answer is typed. 

8.2.8 Registers 

The contents of a register is specified in any expression by enclosing the register 
number in parentheses. For example, 

DM (1) 

displays the contents of Rl. 

The DR directive displays registers and the CR directive can modify the registers. 

8.2.9 Indirection 

Indirection must precede a field. For example, 

DM *0 

causes the value at location 0 to be obtained and displayed as an address. 
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8.3 Accessing the Debugger 

If the system debugger is configured as part of a resident system, the debugger is 
automatically accessed by SYSINIT when the configured system is installed from the 
User SDT. (The installation process is described in Chapter 2 of this volume.) The 
debugger is activated by SYSINIT. The debugger input prompt is a double angle 
bracket (»). 

Debugger directives can be issued from the system console and patches can be made 
in the memory resident image of the system. The debugger is terminated by a TE 
(Terminate) directive. It returns control to SYSINIT, which continues building the 
system as described in Chapter 2. 

There are three other ways the debugger can be accessed: 

• A privileged user task can code a branch and link through the communications 
region variable that points to the debugger (C.DEBUG): 

BL *C. DEBUG 

Branch and link can only be used in modules or tasks that do not reside in the 
extended execution area of MPX-32. 

• For modules that reside in the extended execution area or vary between extended 
and nonextended placement, the MBR_DBG macro can be used to access the 
debugger. The MBR_DBG macro determines the operating mode of the calling 
module and inserts the appropriate code for debugger access. 

• An OPCOM DEBUG directive can be used. 

The system debugger uses stand alone drivers to perform I/O. The debugger routes 
listings to the printer configured as LP7E and it gets directives from the terminal or 
teletype configured as TY7E (usually the system console). Although any terminal 
user can issue the OPCOM DEBUG directive, once the system debugger gains 
control, its prompt is displayed on the system console and it accepts directives only 
from that device. 
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8.4 Debugger Directives 

When the debugger is entered, it initializes bases and sets symbolic mode. It is then 
ready to receive and process directives. 

The directive syntax requires the first two characters be entered unless special 
operators are used. Certain directives contain one or more fields of additional 
information, separated by a comma. 

Debugger directives are summarized below and described in detail in the following 
pages. The summary is divided into three sections: general debugging directives, 
directive list directives, and patch list directives. 

Directive Description 

AB displays all subsequent addresses as numeric (absolute mode) 

AD displays low and high limits of a task address space 

AR evaluates an arithmetic expression and displays its value 

AS converts an instruction into its hexadecimal equivalent 

BA creates, deletes, or modifies the definition of a user base 

and displays its addresses 

BR sets a breakpoint at a specified address 

BY or TE exits the debugger (only when entered by a branch and link) 

CB changes the contents of a base register 

CH displays controller definition table (CDT) entries 

CM changes the contents of memory to a new value 

CO continues tracing or execution from a breakpoint set with 

a BR command 

CR changes the value of a user register 

CT continues processing, setting a one-shot breakpoint at a specified 

address which terminates the trace function 

DB displays the base registers 

DE deletes a breakpoint which was set with the BR command 

DI displays memory locations in instruction format within 

a specified address 

DM displays memory locations within a specified address range 

DQ displays dispatch queue entries 

DR displays all registers 

DS displays memory locations in instruction format within 

a specified address range 
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Directive 

DT 

DU 

EC 

ET 

GO 

HC 

LB 

LP 

LT 

MR 

MS 

PS 

PV 

RB 

RE 

RT 

SE 

SM 

SP 

SY 

TB 

TE 

TR 

TS 

TY 

UD 

VP 


Description 

dumps the event trace table to the printer. This directive assumes 
memory partition at hex 78000 and requires reassembly of the entire 
resident source with the event table enabled. 

dumps output to the line printer 
echoes terminal output to the line printer 
places an event trace point at a specified address 

resumes execution of a user program at a specified address 
or the last known user PSW. Optionally sets a one-shot trap 
at a specified address. 

displays the state queue head cells 

lists all breakpoints 

sets line printer output mode 

displays a list of the current mobile event trace points 
allows inspection of one CPU map register pair on a 32/87 
modifies scratchpad locations 

displays last known user PSD, program counter, condition codes, 
and registers 

converts a physical address to a virtual address 
resets all bases to the default values 

remaps the debugger to the map associated with a specified 
dispatch queue entry number or the current program 

removes a mobile event trace point at a specified address 

compares specified words, in the range set by the SM directive, 
to a specified value 

sets the mask as a left-justified hexadecimal number for 
the SE directive 

dumps CPU scratchpad RAM locations 

displays subsequent addresses as displacements from bases. 

This is symbolic mode. 

displays instructions that cause TSA stack push 
same as BY directive 

traces user programs and displays each instruction after execution 
terminates trace initiated by the TR directive 
sends output to a terminal and resets echo mode 
displays unit definition table (UDT) directive entries 
converts a virtual address to a physical address 
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The following directives construct a list of system debug directives and execute them 
at specified breakpoint(s). The directive list is also executed at the users request. The 
BR directive executes a directive list on a breakpoint. 


Directive 

Description 

CD 

displays the contents of the directive list 

CE 

zeros the command list 

CL 

turns off the directive list building mode 

CS 

enters the directive list building mode 

CX 

executes the directive list 


The following group of directives can be used during the debug phase of IPL. These 
directives build a patch list of debug directives to apply to the system image being 
IPLed. The patch list is automatically written to disk as part of the system image at 
the return to SYSINIT from the system debugger. Execution of the patches is 
automatic at the beginning of the debug phase of EPL. 


Directive 

PD 

PE 

PR 

PT 

PX 


Description 

displays the contents of the patch list 
zeros the patch list 
turns off the patch list building mode 
enters the patch list building mode 
executes the patch list 


8.4.1 AB (Absolute) Directive 

The AB directive displays all subsequent addresses as numeric (absolute mode). 


Syntax 

AB 

8.4.2 AD (Address) Directive 

The AD directive displays the low and high limits of a task’s address space. 


Syntax 

AD 
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8.4.3 AR (Arithmetic) Directive 

The AR directive evaluates an arithmetic expression. The debugger processes the 
expression in its left to right order and displays the value. 


Syntax 

AR expr 

expr is the arithmetic expression to be evaluated 

8.4.4 AS (Assemble Instruction) Directive 

The AS directive converts an assembly language instruction to its 8-digit hexadecimal 
equivalent. Instruction groups supported are memory-reference and register-register. 

I/O instruction group is not supported. Also, the Assembler mnemonics used in the 
syntax for this directive are abbreviated to only 4 characters rather than 5 characters. 

Use the DI directive to display the valid 4-character mnemonics available for use with 
the AS directive. 

Syntax 

AS [B] opcode [ ,reg ] [, offset] [, index] [ (Breg) ] 

B activates base mode operation y y 

opcode is the 4-character Assembler mnemonic 

[,reg] is a number from 0 to 7 

[, offset] is a hexadecimal number or an expression 

[, index] is the number 1, 2 or 3 

[ (Breg) ] is the base register (B0-B7) that is used for base mode instructions. If this 
parameter is specified, base mode must be activated (B parameter). 

8.4.5 BA (Base) Directive 

The BA directive defines a user base by adding its name to the internal base definition 
table, deletes a user base name from the base table, or redefines a user base by 
changing the value specified in the base name’s definition. The new base possesses 
the physical or virtual attribute associated with the addr field unless overridden with 
the P or V options. 

A maximum of 20 bases are definable. 
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Syntax 

BA base [ addr ] [,P I ,V] 

base is a 1 -character alphanumeric base name. 

[addr] is the logical or physical address for the base dependent upon the virtual 
or physical context of addr. If not supplied, the specified base name is 
deleted. If addr is supplied and base is already defined, base is redefined 
to represent addr. 

[,P] overrides the context for addr and specifies the physical attribute for base 

[,V] overrides the context for addr and specifies the virtual attribute for base 

8.4.6 BR (Breakpoint) Directive 

The BR directive sets a breakpoint at a specified address. A breakpoint remains in 
effect until cleared with the DE directive. Upon execution of the breakpoint, 

BRK Qaddr is displayed along with the contents of the registers to indicate which 
breakpoint was executed. A maximum of 8 breakpoints can be set. Breakpoints and 
event trace points (see ET command) cannot be set at the same address location. 

Syntax 

BR addr [,C] [,B] 

addr is the address at which the breakpoint is set 

[,C] specifies execution of a debug directive list at this address 

[,B] specifies that the breakpoint resides in extended MPX-32 

8.4.7 BY (Bye) Directive 

The BY directive exits the debugger when entry was made using a branch and link 
instruction. The debugger returns control to the calling program. See also the TE 
directive. 

Syntax 

BY 
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8.4.8 CB (Change Base Register) Directive 

The CB directive modifies the contents of one or more user base registers. 


Syntax 

CB reg, value [, value]... 

reg is a user register, B0-B7 

value is the 32-bit value to be stored in the specified register. Successive values 
are stored in consecutive user registers. Two successive commas with no 
intervening value skips the user register corresponding to the missing 
value, leaving its contents unchanged. If B7 has been altered or skipped 
and an unused value remains, it is ignored. 


8.4.9 CD (Display Command List) Directive 

The CD directive displays the contents of the system debugger directive list. 

Syntax 

CD 

8.4.10 CE (Zero Command List) Directive 

The CE directive zeros the system debugger directive list. Once zeroed, the list can 
be replaced or left zeroed to remove the directive list function. 

Syntax 

CE 

8.4.11 CH (Display Controller Definition Table Entry) Directive 

The CH directive displays one or all CDT entries. 

Syntax 

CH [index] 

[index] is the index of the CDT entry to be displayed. If not specified, all CDT 
entries are displayed. 
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8.4.12 CL (Terminate Build Directive List Mode) Directive 

The CL directive terminates the system debugger directive list building mode. 

Syntax 

CL 

8.4.13 CM (Change Memory) Directive 

The CM directive changes the contents of one or more words to a new 32-bit value. 
The specified address is changed to either a right-justified hexadecimal value or a 
left-justified blank-filled ASCII text word. 

Syntax 

CM addr, value [, value]... 

addr is the address of the first or only word to be changed 

value is the 32-bit value to be stored at the specified address. Successive values 

are stored in consecutive words beginning at addr. Two consecutive 
commas with no intervening value can be used to skip the memory 
address corresponding to the missing value, leaving its contents 
unchanged. 

8.4.14 CO (Continue) Directive 

The CO directive continues tracing or execution from a breakpoint. If the user is in 
trace mode (entered by a TR directive), tracing continues and the debugger does not 
exit while TR is active. If the user is not in trace mode, execution continues. (See 
GO directive). 

Syntax 

CO [addr [,stop] ] 

addr is the address where program execution with optional trace continues. If 

not specified, the program resumes from the last known location. 

stop is the address where execution and tracing terminates 
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8.4.15 CR (Change Register) Directive 

The CR directive modifies the contents of one or more user registers. 


Syntax 

CR reg, value [, value]... 

reg is a user register, R0-R7 

value is the 32-bit value to be stored in the specified register. Successive values 
are stored in consecutive user registers. Two consecutive commas with 
no intervening value skips the user register corresponding to the missing 
value, leaving its contents unchanged. If user R7 has been altered or 
skipped and an unused value remains, it is ignored. 

8.4.16 CS (Build Directive List) Directive 

The CS directive puts the system debugger in the directive list build mode. The 
following directives are not valid once CS is specified: CD, CE, CL, CX, or another 
CS directive. 

Syntax 

CS 

8.4.17 CT (Continue then Terminate) Directive 

The CT directive continues processing from a specified dollar sign ($) location, setting 
a one-shot breakpoint at a specified address which terminates the trace function. 

Syntax 

CT [addr] 

[addr] is the address where an optional one-shot breakpoint is set. Tracing is 
terminated and the users program re-entered. If not specified, return to 
the user’s program is at the last known program counter value. 


8.4.18 CX (Execute Directive List) Directive 

The CX directive executes the system debugger directive list. 


Syntax 

CX 
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8.4.19 DB (Display Base Register) Directive 

The DB directive displays one or more user base registers. 

Syntax 

DB [Breg] 

[i Breg ] is a user base register, 0-7. If no register is specified, the default is all 

user base registers are displayed. 

8.4.20 DE (Delete) Directive 

The DE directive deletes a breakpoint that was set with a BR directive and restores 
user instructions to their original locations. 

Syntax 

DE addr 

addr is the address where the breakpoint is deleted and the user’s instruction is 

restored to its original location 

8.4.21 Dl (Display Instruction) Directive 

The DI directive displays any memory locations within a specified address range, in 
instruction format, one line at a time (same as DS directive). 

Syntax 

Dl addl [ ,add2 ] [,B] 

addl is the address where the display starts 

[,add2] is the address where the display ends. If not specified, the display 

continues until a character other than a carriage return is entered at the 
end of a line. 

[,B] specifies base mode instruction display 


8.4.22 DM (Display Memory) Directive 

The DM directive displays all memory locations within the specified address range. A 
carriage return continues the display; any other character entered terminates the 
display. 
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Syntax 

DM [addl [,add2] [, number] ] 

addl is the address where the display starts 

[,add2] is the address where the display ends. If not specified, the ending address 

defaults to the starting address. For example, addl is the only location 
displayed. 

[, number] is the number of words to be displayed per line on the console (minimum 
of 1, maximum of 8). If not specified, die default is 4. 


8.4.23 DQ (Display Dispatch Queue Entry) Directive 

The DQ directive displays one or all DQE entries. 


Syntax 

DQ [index] 

[index] is the index of the DQE entry to be displayed. If not specified, all DQE 
entries are displayed. 

8.4.24 DR (Display Register) Directive 

The DR directive displays the memory locations of registers. 


Syntax 

DR [reg] 

[reg] is a user register (R0-R7). If not specified, all registers are displayed. 

8.4.25 DS (Display Symbolic) Directive 

The DS directive displays any memory locations within a specified address range, in 
instruction format, one line at a time (same as DI directive). 


Syntax 

DS addl[,add2] [,B] 


addl is the address where the display starts 

[,add2] is the address where the display ends. If not specified, the display 

continues until a character other than a carriage return is entered at the 
end of a line. 

[,B] specifies base mode instruction display 
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8.4.26 DT (Display Event Trace) Directive 

The DT directive dumps the event trace table to the line printer. Event trace is 
disabled until printing is completed. 

Notes: 

This directive assumes memory partition at hexadecimal 78000 and requires 
reassembly of the entire resident source with event trace enabled. 

Syntax 

DT 

8.4.27 DU (Dump) Directive 

The DU directive writes a range of memory to a line printer. ASCII format is used 
for the right-hand side of the memory display. 

Syntax 

DU [start [,stop] ] 

start is the memory address where the dump starts 

stop is the memory address where the dump stops. If not specified, the default 

is the end of the operating system. 

If no parameters are specified, the entire operating system area is output. 

8.4.28 EC (Echo) Directive 

The EC directive generates hard copy output when a CRT is the terminal device. 
Output is listed, line by line, on the line printer for every carriage return on the 
terminal. To terminate the EC directive, specify the TY directive. 

Syntax 

EC 

8.4.29 ET (Enter Event Trace Point) Directive 

The ET directive places an event trace point within either resident or nonresident code 
without requiring reassembly of a program. To turn on the trace, this directive resets 
bits 21 and 22 of C .TRACE. 
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Prerequisites are: 

1. The system must have been SYSGENed with a static partition for the event trace 
table. 

2. Both H.DBUG (System Debugger) and H.IP06 (SVC Trap Handler) must have 
been assembled with TRACE set true. 


A maximum of 8 event trace points can be set. Event trace points and breakpoints 
(see BR directive) cannot be set at the same address location. 


Syntax 

ET addr [,B] 

addr is an absolute or relative address with a symbolic base 

[,B] specifies that the event trace point resides in extended MPX-32 

8.4.30 GO (Go) Directive 

The GO directive transfers control to the user task, optionally setting a one-shot trap 
at a specified address. 

Syntax 

GO {start [ ,stop ] ] [,B] 

[start] start is the address where the program starts executing 

[,stop] stop is the address where the program stops executing. When specified, a 

breakpoint is set at this address before execution begins at the start 
address. If not specified, the program is reactivated at the start address. 

[,B] specifies base mode execution 

If no parameters are specified, the program is entered at the last known user PSW. 

8.4.31 HC (Display Dispatch Queue Head Cell) Directive 

The HC directive produces a 3-column display of the MPX-32 state queue head cells. 
Each entry is 3 words long. 


Syntax 

HC 
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8.4.32 LB (List Breakpoint) Directive 

The LB directive lists all active fixed breakpoints set using a BR directive. 

Syntax 

LB 

8.4.33 LP (Line Printer) Directive 

The LP directive directs output to the line printer. If the user is tracing, no request is 
made for input after each instruction. A breakpoint must be set to terminate the trace. 

Syntax 

LP 

8.4.34 LT (List Mobile Event Trace Point) Directive 

The LT directive lists current mobile event trace points within resident or non-resident 
code. 

Prerequisites are: 

1. The system must have been SYSGENed with a static partition for the event trace 
table. 

2. Both H.DBUG (system debugger), and H.IP06 (SVC trap handler), must have 
been assembled with TRACE set true. 

Syntax 

LT 

8.4.35 MR (Map Register) Directive 

The MR directive allows inspection of one CPU map register pair. This directive is 
available only on the 32/87 computer. 

Syntax 

MR index 

index is the number of the map register from 0 to FF 
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8.4.36 MS (Modify CPU Scratchpad Location) Directive 

The MS directive modifies any location within the CPU scratchpad random access 
memory. Because the scratchpad is used by the CPU to process I/O and interrupt 
requests, incorrect modification of scratchpad locations could cause undesirable 
results. This directive should be used with extreme caution. 

The scratchpad address specified in this directive can be within two ranges. The first 
range is a number between 0 and FF corresponding to the actual scratchpad address as 
defined in hardware. The second range is a number between 300 and 6FC 
corresponding to a scratchpad location obtained by using the SP directive to display 
all scratchpad locations. 

If an invalid address is specified or an attempt is made to write past the end of 
scratchpad, an error message is displayed. 

Syntax 

MS loc, value [, value]... 

loc is the scratchpad address 0 to FF, or 300 to 6FC 

value is the 32-bit value stored in the specified location. Successive values are 

stored in successive locations. 

8.4.37 PD (Display Patch List) Directive 

The PD directive displays the contents of the system debugger patch list. The display 
list is either the previous patch list written to disk or the current edited version. 

Syntax 

PD 

8.4.38 PE (Zero Patch List) Directive 

The PE directive zeros the system debugger patch list. Once zeroed, the list can be 
replaced or left zeroed to remove the patch function. 


Syntax 

PE 


8-20 


System Debugger 



Debugger Directives 


8.4.39 PR (Terminate Build Patch List Mode) Directive 

The PR directive terminates the system debugger patch list building mode. 

Syntax 

PR 

8.4.40 PS (Program Status) Directive 

The PS directive displays the user program status doubleword (PSD), program 
counter, condition codes, and registers. 

Syntax 

PS 

8.4.41 PT (Build Patch List) Directive 

The PT directive causes the system debugger to enter the patch list build mode. The 
following directives are not valid after PT has been specified: PD, PE, PR, PX, or 
another PT directive. 

Syntax 

PT 

8.4.42 PV (Convert Physical Address to Virtual Address) Directive 

The PV directive converts a physical address to a virtual address. 

Syntax 

PV addr 


addr is the physical address to be converted to a virtual address 


8.4.43 PX (Execute Patch List) Directive 

The PX directive executes the system debugger patch list. 

Syntax 

PX 
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8.4.44 RB (Reset Bases) Directive 

The RB directive resets all bases to their initial default values. 

Syntax 

RB 

8.4.45 RE (Remap) Directive 

The RE directive remaps the debugger to the map associated with a program. 

Syntax 

RE [number] 

[number] is the dispatch queue number in the range 0 to FF where remapping is 
associated. If not specified, remapping defaults to the dispatch queue 
number in C.CURR. 


8.4.46 RT (Remove Event Trace Point) Directive 

The RT directive removes a mobile event trace point within resident or nonresident 
code. 

Prerequisites are: 

1. The system must have been SYSGENed with a static partition for the event 
trace table. 

2. Both H.DBUG (system debugger), and H.IP06 (SVC trap handler), must 
have been assembled with TRACE set true. 

Syntax 

RT addr 

addr is an absolute or relative address with a symbolic base 
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8.4.47 SE (Search Equivalent) Directive 

The SE directive compares specified words to a specified value. Each word is ANDed 
with the search mask (see SM directive) before being compared to the value. Each bit 
in the range is listed. 

Syntax 

SE value, start, stop 

value is the value where each word is compared 

start is the address where the search begins 

stop is the address where the search ends 

8.4.48 SM (Set Mask) Directive 

The SM directive sets the mask for the SE directive. The mask parameter is 
interpreted as a left-justified hexadecimal number or right-justified ASCII character 
string. 

Syntax 

SM [mask] 

mask is a new mask value. If not specified, the default is the previously entered 
value; if none, X’FFFFFFFF’ is used. 

8.4.49 SP (Scratchpad Dump) Directive 

The SP directive outputs to the terminal the contents of the scratchpad locations (23 
lines of text are output at a time). A carriage return continues output, entering any 
other character terminates output. 

Syntax 

SP [loc] 

[loc] is the CPU scratchpad address 0 to FF. If not specified, all scratchpad 

locations are displayed. 

8.4.50 SY (Symbolic) Directive 

The SY directive displays all subsequent addresses as displacements from bases 
(symbolic mode). 

Syntax 

SY 
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8.4.51 TB (Trace Back) Directive 

The TB directive displays the instructions that caused each TSA stack push. TB is 
only valid if there is a current task which is not authe base level of its stack. Make 
sure the debugger is mapped with the correct task space. The instructions are 
displayed in logical order. For example, the first instruction shown is the instruction 
executed by the task (usually a SVC) that caused the first push. Because some 
operating system routines allocate extra stack frames as work space, some displays can 
contain apparently invalid information. 

Syntax 


8.4.52 TE (Terminate) Directive 

The TE directive exits the debugger if it was entered using a branch and link. Control 
returns to the calling program. See the BY directive. 

The TE directive should not exit from a breakpoint. See the CO and CT directives. 

Syntax 

TE 

8.4.53 TR (Trace) Directive 

The TR directive executes and displays results of user instructions one at a time. 
Addresses are displayed as a base character plus offset value. 

The last instruction executed is displayed and the cursor is held at the end of the line 
awaiting a user directive. A carriage return or line feed causes the next instruction to 
be executed and displayed. An up arrow ( A ) causes the previous instruction to be 
redisplayed. An equal sign (=) causes the hexadecimal equivalent of the instruction 
just executed to be displayed. Any other character causes the debugger to prompt for 
a directive. 

Symbols established by the BA directive are used for display purposes if the SY 
directive was set. 

Execution tracing is not permitted within a mapped out task’s virtual address space. 
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Syntax 

TR [start [ ,stop ] ] [,B] 

[start [ ,stop ] ] 

start is the address of the first user instruction to be traced. If not 

specified, the default is $ (current PSD value). 

stop is the address of the last user instruction to be traced. If not 

specified, tracing continues without bounds. 

[,B] specifies base mode display and execution for tracing through extended 

MPX-32. 

8.4.54 TS (Trace Stop) Directive 

The TS directive exits the trace mode initiated by the TR directive. All further I/O is 
directed to the user’s terminal. 

Syntax 

TS 

8.4.55 TY (Terminal) Directive 

The TY directive directs output to a terminal and to reset EC (Echo) mode. 

Syntax 

TY 

8.4.56 UD (Display Unit Definition Table Entry) Directive 

The UD directive displays one or all UDT entries. 

Syntax 

UD [index] 

[index] is the index of the UDT entry to be displayed. If not specified, all UDT 
entries are displayed. 
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8.4.57 VP (Convert Virtual Address to Physical Address) Directive 

The VP directive converts a virtual address to a physical address. 


Syntax 

VP addr 


addr is the virtual address to be converted to a physical address 

8.5 System Debugger Practice Debug Session 

The following example is for first time users of the system debugger. It is 
recommended that the user try the following directives on the system console of an 
MPX-32 system. This should only be done on a stand-alone system (with no other 
users on the system), because it is very easy for the inexperienced user to crash the 
system. 

This example does not attempt to explain every directive or even the complete syntax 
of the directives. It is intended to help use the system debugger. While using this 
example, please refer to the directives descriptions and read each description before 
proceeding. 

8.5.1 Step One - Accessing the Debugger 

The debugger is generally entered using the instruction: 

BL *C. DEBUG 

This is the case whether it is entered by a user written program or through the 
OPCOM DEBUG directive. The calling program must be privileged to make this 
call. Also, the macro ’M.EQUS’ or ’M.COMM.’ must be included in the program to 
allow the symbol ’C.DEBUG’ to be properly assembled. 

To exit the debugger, when entered by a branch and link, use the TE directive. 

At the operator’s console, invoke the debugger using OPCOM. 

TSM>OPCOM TSM>OPCOM DEBUG TSM> ! DEBUG 

??DEBUG or » or » 

» 

Then exit. 

»TE »TE »TE 

?? TSM> TSM> 

Notice you return to the process you left. 
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8.5.2 Step Two - Task Debugging with the System Debugger 

While it is normally best to debug a task using the task debugger, there are cases 
where the system debugger is the better tool, because the system debugger allows the 
user to trace through system calls. 


8.5.3 Using the System Debugger to Display Memory 

At the console, perform the following: 

TSM> ! DEBUG Enter the debugger (OPCOM is the task) 

» 

Because Assembler generated listings have the program relative addresses listed, it is 
necessary to set a base at the start of the task to be debugged. This allows the use of 
the offsets given by the Assembler. To do this, it is necessary to know where the task 
starts. This information is contained within the Task Service Area (TSA) represented 
by the predefined debug base N. 

To set a user base, first select the character desired as the base. In this example, use 
P. Using the macro expansion of the TSA variables, the start of the task is at T.BIAS 
which equates to hexadecimal ’704’. To set the base, use the following debug 
directive. 

»BA P *704N 

This sets base P to equal the virtual address stored at hexadecimal ’7 04’ relative to 
the TSA. The * indicates the address specified is indirect. When referencing 
locations that consist of an offset and a base, as in the 7 04N above, the + operator is 
implied. 

Now, use the base to look at information contained within the task. 

To find where the debug call is made, use the DI (Display Instruction) directive to list 
the instructions with their program relative offsets. The current task program counter 
is pointing one word past die call to the debugger, so the following instruction 
displays the debug call: 

»DI $-4 

P+5C40 BL 0,X1 
P+5C44 LF R0,P+20 

The $ indicates the current program counter location. In this case, the debugger is 
entered by an indexed branch to allow OPCOM to test for the presence of the 
debugger before attempting to branch to it. 

To look at more instructions, repeated carriage returns display successive physical 
memory locations in instruction format. 

To display noninstruction memory contents, use the DM (Display Memory) directive. 
This directive is the default directive. If only a number is entered, the data contained 
at the specified address is displayed on the terminal. 
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For example: 

»DM 50P 

P+50 46554C20 *FUL * 

»50P 

P+50 46554C20 *FUL * 

The DM directive is not always defaultable. If the memory location to be displayed is 
ambiguous with a debug directive, then DM must be entered. 

»EC04 Would be interpreted by the debugger as the ECHO directive. DM 
must be entered. 

»DM EC04 

Other potentially ambiguous directives are: 

• AB — set absolute addressing mode 

• AD — display task address limits 

• BA — define base 

• DE — delete breakpoint 

• EC — echo terminal output to line printer 

To display the registers at any point, two directives are used. The first is the DR 
(Display Register) directive. DR lists any or all of the eight general purpose registers. 


»DR 

A1037C44 00021F8C 00000000 0000002F D /* 

OOOOOOOD 00000004 44544255 20202020 * DEBU * 


»DR R5 

00000004 *....* 

The second directive is the PS (Program Status) directive. PS lists the program status 
doubleword, program counter, condition codes, and general purpose registers. 

»PS 


PSD= 

PC= 

A0037C44 

G+103C 

80000058 
CC= 0100 





RO-7 

A1037C44 

OOOOOOOD 

00021F8C 

00000004 

00000000 

44544255 

0000002F 

20202020 

★ # 
★ 

D. . 

/* 

. .DEBU * 


Often, calls to system services require data structure addresses be passed in registers. 
An example is the FCB address in almost all I/O service calls. If examination of such 
a structure is required, two methods can be employed. 

The first is to display the registers, or a particular register using the DR directive. 
Then the memory locations pointed to by the register containing the data can be 
examined by the DM (Display Memory) directive. If the last base referenced had a 
physical attribute, the memory displayed is physical. If the last base had a virtual 
attribute, the memory displayed is logical. 
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The second involves using the DM directive with a special operator, the parentheses, 
indicating ’contents of a register’. A number in the range of 0 to 7 is enclosed in 
parentheses and indicates the contents of a register. To look at a 16 word FCB, use 
the following directive. 

»DM (1, (1+40 
or 

»(1, (1 + 40 

By using the debug directives to their maximum potential, a great deal of information 
about a task is made readily available to the user. Two examples of such directives 
follow. 

1. Displaying the Dispatch Queue Entry for the Current Task 

In general, have an MPX-32 Technical Manual available so that system data 
structures can be analyzed. For the debugger to display the actual relative 
addresses displayed in the diagrams, and not the absolute addresses, set a debug 
base. Q is an appropriate base to use for the dispatch queue. Set the base as 
follows. 

»BA Q *8E8 

Because the * indicates indirect, base Q is set to the address stored at X’8E8’. 
The number X’8E8’ was determined by looking at a C-dot cross reference for 
C.CURR. This is the dispatch queue head cell for the current task. To examine 
any part of the queue entry, refer to the proper offset followed by Q. 

»Q, 20Q 

Q+0 000008E8 000008E8 3C3C3C02 17000015 * <«. . . 

Q+10 53595354 454D2020 4F50434F 4D202020 *SYSTEM OPCOM * 

The state queue linkage, the task number, the owner name, and the task name 
for the current task are shown. 

2. Traversing a Linked Queue 

If the integrity of a linked queue is in doubt, the debugger easily traces through 
the entries as shown below: 


»Q 

Q+0 

000008E8 


»* 

8E8 

00003D30 

* . . =0* 

»* 

Q+0 

000008E8 



Because the * indicates indirect, it refers to the address displayed on the previous 
line. In this manner, linked queues of any length can be traversed to ensure they 
contain all required entries, are connected, or whatever else may be desired. 


8.5.4 Using Debug to Display a Program 

Assume a program is failing in one particular subroutine. By using the breakpoint 
capabilities of debug, let the program run at machine speed until the trouble spot is 
encountered. To set a breakpoint, use the following directive. 

»BR addr 
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To let the program nm until reaching the breakpoint, do the following: 

»TE If the debugger was entered by BL *C . DEBUG 
(or) 

»BY If the debugger was entered by BL *C . DEBUG 
(or) 

»CO If the debugger was entered from a breakpoint 
(or) 

»CT If the debugger was entered from a breakpoint 

An explanation of the four different debug exit directives follows. 

TE or BY either of these two directives can exit the debugger when it is entered by a 
branch and link. These are the only directives that are acceptable. Use of 
the CO or CT directives produce errors later on. 

CO continues the last mode of execution. If the user was tracing, then 

terminated trace mode using a noncarriage return input and now wishes to 
resume tracing, either CO or TR accomplishes it. If the program was 
running normally and was stopped by a debug breakpoint, CO will 
continue execution of the program in run mode. This directive should be 
used only if the most recent entry into the debugger was through a 
breakpoint. 

CT continues execution of the task in run mode regardless of the previous 

mode (trace or run). Like the CO directive, CT should only be used when 
the most recent entry into the debugger was through a breakpoint. 

Upon reaching the breakpoint, the following is displayed: 


»BR 5C48P 
»TE 

BRK P+5C48 CC 0100 
RO-7 

89032C08 FFFFFFFO 00000000 0000002F /* 

0000000D 00000004 44454255 20202020 * DEBU * 


Note: Breakpoints cannot be set on SVC instructions. An error message is 

displayed should the user attempt this. The trace mode should only be used 
when the debugger is invoked by a breakpoint. If entry was accomplished by 
a branch and link, a breakpoint should be set, TE executed, and the trace 
started after entering the breakpoint. Breakpoints cannot be set within 
mapped out tasks. 

When the area of code to be debugged has been reached, a helpful directive is TR 
(Trace). This directive executes instructions, one at a time, and displays the 
disassembled instruction, along with any pertinent registers or memory locations, on 
the console. 

»TR 
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After tracing several instructions, a bug is found. The instruction at xxxtP is: 

LD R4,100,X2 
what should have been there is: 

LD R4,100,X3 

In order to continue the debugging process, the instruction must be modified and re- 
executed. The CM (Change Memory) directive does this. 

»CM addr, value 

This directive requires the correct hexadecimal value for the new instruction. The 
debugger assembles memory reference and register-register instructions. The result is 
displayed in hexadecimal. To find the value needed above use: 

»AS LD , 4 , 1 0 0 , 3 
AE600102 

Then to patch the bad instruction: 

»CM xxxcP, AE 60 0102 
and to re-execute it: 

>>TR xxxrP 

If it is desired, registers can be modified by using the CR directive. 

This method for patching a program works for single line errors. That is, a bad 
memory address, an incorrect register, or any other error requiring modification of 
only one line of code. For more major problems that require the insertion of more 
instructions, the following technique can be employed. 

Because several low memory areas (for example, X’DO’ to X’FF’) are not used after 
the system is booted, we can use these locations as a scratch area for building patches. 
MPX-32 has a section of memory reserved for patching by J.INIT that can build 
temporary debug patches. It is found by examining C.MPAC (determine actual 
address by assembling M.EQUS). This word contains the next available address 
within the MPX-32 patch area. The patch area end address is contained in C.MPAH. 

To use the available memory locations, first, select the instruction where code is to be 
added. Using the area mentioned above, replace the instruction with a branch to 
X’DO’. At location X’DO’, build the desired instructions ending with a branch back to 
the proper return location. This is generally one word past the branch to X’DO’. The 
instructions are, for the most part, generated by the debug AS directive, placed by the 
CM directive, and verified before being executed by the DI directive. 


8.5.5 Summary 

The best way to learn the debugger is to use it. Reread section 8.4, Debugger 
Directives, in this chapter for complete descriptions of the directives because the 
following summary does not cover all of the directives or make full use of the ones 
covered. Type carefully because the debugger executes exactly as requested. If you 
do not specify a base for an address, the debugger references the absolute location. 
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8.6 Example of Directive List Use 

Problem: 

Log contents of FCB after repeated I/O operations performed by new resident 
operating system module without continuous user intervention. 

Solution: 

Place a breakpoint at 63C relative to new module. Start with the directive list 
option and create a directive list to dump the FCB and continue. 

Implementation : 

Build Directive List 

1. Access the system debugger 

TSM>! DEBUG 

2. Clear the directive list 

»CE 

3. Set directive list build mode 

»cs 

4. Construct directive list to dump FCB 

»DU (1, (1 + 40 
»CO 

5. Terminate directive list build mode 

»CL 

6. Display directive list 

»CD 

Resultant CRT display: 

CL -+ DU (1, (1 + 40 
CL -+ CO 

7. Set breakpoint 

»BR 63CX, C 

8. Return to TSM 

»TE 
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8.7 Example of Patch List Use 

Problem: 

System is generated containing user created operating system modules. The 
new module contains the patchable coding error 

LW Rl, 0W,R3 
(should be) 

LA Rl, 0W,R3 

Solution: 

System debugger patch list containing a Change Memory (CM) directive 

Implementation: 

Build Patch List 

1. IPL system. When the debug prompt appears, locate erroneous instruction 
(for example, location 43C relative). 

2. Use the Assemble directive to construct new instruction 
»AS LA, 1,0, 3 

Result: 34E00000 

3. Clear patch list 
»PE 

4. Set patch list build mode 

»PT 

5. Build patch list 

»CM 43C(relative), 34E00000 Replace instruction at 43C relative 
»TE Return to SYSINTT 

6. Terminate patch list build mode 
»PR 

7. Display patch list 
»PD 

Result: 

PL -» CM 43C(relative), 34E00000 
PL ->■ TE 

8. Execute patch list 
»PX 

Result: 

Location 43C (relative) changed to 34E00000 and control returns to 
SYSINIT when the patch list is written to disk. 
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9 Online System Patch Facility (J.INIT) 


9.1 Introduction 

J.INIT provides for temporary or permanent patching of the MPX-32 resident image. 

In addition, J.INIT performs the Alterable Control Store/Writable Control Store 
(ACS/WCS) loading function. See Chapter 12 of this volume. 

J.INIT also initiates mount requests for any public volumes to be mounted at IPL 
time. The information for these requests is provided in the system file, M.MOUNT. 
See section 9.7, Automatic Mounting of Public Volumes, in this chapter. 

J.INIT processes patch directives from the patch file. 

The patch file name is supplied in the SYSGEN PCHFILE directive. This file should 
contain valid patch directives as described in the Patch Directives section of this 
chapter. The patch file is maintained by the Text Editor and should be stored as a 
blocked, uncompressed file. An associated symbol table file is built by SYSGEN 
when the SYMTAB directive is specified. The SYSGEN PATCH directive should 
define the size of the patch area. 

Only one patch area is used for extended, nonbase, and mapped out modules. If the 
extended mode is activated at SYSGEN, the patch area must be located in the first 
16KW of memory. Otherwise, the patch area can be located anywhere in the resident 
MPX-32 system. 

Patches for any modules that are located in extended memory must be constructed by 
using the appropriate base register instructions. J.INIT is unable to perform opcode 
decoding or substitution for extended modules. Memory reference instructions must 
be encoded with the base register field equal to 0. If these instructions are designated 
relocatable, J.INIT inserts the appropriate base register and offsets into the address 
field. J.INIT generates an error if an attempt is made to enter a relocatable base 
register instruction with a nonbase zero field. 

Entry of a patch that invokes a branch between extended and nonbase modules is not 
supported. Because the adapter code addresses are not available to J.INIT, and 
because J.INIT cannot build adapter sequences, the user must locate the required 
adapter and enter the branch in absolute mode. 

Patch processing terminates when the Exit (/E) directive is encountered in the patch 
input file. At this time, an audit trail of all patches specified is written to the SLO 
file. The audit trail listing is suppressed by specifying the NPR option with the option 
(/O) directive. The patch program accepts directives to control processing. The 
general format of a directive is: 

Idflflfffh 


Id is the directive name that must be followed by one or more spaces. This is 

called field 1 for error messages. 

f2 -fn are fields containing the names, values, and special symbols processed by 
the directive. Fields must be separated by one or more spaces or a comma. 
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For a patch directive to reference an extended module’s DSECT data, SYSGEN 
generates system symbol table entries containing the DSECT base addresses. The 
name for these entries in the system symbol table is the module name with the first 
character replaced by For example, $.REMM indicates the address of 
H.REMM’s DSECT data. These names are used on relocatable patches that are 
DSECT relative. 

One character module names (A,B,C,etc.) or module names with only the first 
character unique (AMOD, BMOD, CMOD, etc.) cause the generation of multiply 
defined DSECT symbol table entries ($,$MOD). This generates an error in J.INIT. 


9.1.1 Dedicated Names 

Dedicated names used by J.INIT are: 

Dedicated 

Name Description 

$ equivalent to the address of the next free patch area location 

R indicates a relative address in the positive direction 

-R indicates a relative address in the negative direction 

; delimits fields to be processed and comments 

9.1.2 Conventions 

All field entries on patch directives must conform to the following conventions: 

name 1 to 8 ASCII characters, one of which must be nonnumeric 

value 1 to 8 hexadecimal digits; leading zeros need not be specified. Only 

whole words are generated. 

address 1 to 5 hexadecimal digits; leading zeros need not be specified. Must be 
word resolution (bits 30-3 1 equal 0). 

label 1 to 8 ASCII characters, one of which must be nonnumeric 
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9.2 Patch Directives 

Patch directives are summarized below and described in detail on the following pages. 


Directive 

Description 

/ B 

define a base address 

/c 

change the contents of a memory location 

ID 

define a named value 

/ E 

exit 

/ G 

go to the patch area from a specified mem 

/ 0 

select patching options 

/ P 

define a patch area 

/ R 

return from the patch area 

/F, /N ,/r 

process patch directives conditionally 


/$ enter a value into the patch area 

/; comment only 


9.2.1 / B (Define a Base Address) Directive 

The /B directive allows a name to be equated to a base address. This definition is 
inserted in the internal symbol table and can be referenced by subsequent directives. 


Syntax 

IB name address 

name is equated to address 
IB namej name 2 

namej is equated to the address value of name 2 

9.2.2 1C (Change the Contents of a Memory Location) Directive 

The /C directive changes the value of any location in memory. 


Syntax 

/ C address value 

the specified value is inserted at the specified address 
1 C address value R 

the address field of the value parameter is added to the address parameter to form the 
address field of value. The specified value is inserted at the calculated address. 

/ C address value -R 

The address field of the value parameter is subtracted from the address parameter to 
form the address field of value. The specified value is inserted at the calculated 
address. 
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/C name address value 

The value of the name parameter is added to the address parameter to form the actual 
address. The specified value is inserted at the actual address. 

/ C name address value R 

the specified value is inserted at the specified address, relative to name. The value of 
name is added to value to form the actual address. 

/C name address value -R 

the specified value is inserted at the specified address, relative to name. The address 
field of value is subtracted from name to form the address portion of value. 

/C namej address value name2 

the value of is added to the value parameter and inserted at the actual address. 

The value of name j is added to the address parameter to form the actual address. 

9.2.3 /D (Define a Named Value) Directive 

The /D directive equates a name to the address of a value. The value is stored in the 
next free location of the patch area. The definition is inserted in the internal symbol 
table and can be referenced by subsequent directives. 

Syntax 

/ D name value 

name is equated to the address of value in the patch area 
/D name j name 2 

namej is equated to the address of the value of name 2 in the patch area 

9.2.4 IE (Exit) Directive 

The fE directive terminates directive processing. 

Syntax 

/ E 
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9.2.5 /G (Go to the Patch Area from a Specified Memory Location) 

Directive 

The /G directive inserts an unconditional branch to the patch area at any memory 
location. The location branched to will be the next free location of the patch area 
plus, optionally, an offset. 

Syntax 

/ G address 

an unconditional branch to the specified address of the patch area is inserted 
/ G name address 

an unconditional branch to the specified address of the patch area relative to name is 
inserted. The value of name is added to address to determine the actual address of the 
branch in the patch area. 

/ G name address value 

an unconditional branch to the patch area at address, relative to name is inserted. The 
branch is to the next free patch location plus value number of bytes (word resolution). 
The offset area is thus reserved. The basic form, with no name field, can also be used. 

9.2.6 10 (Select Patch Options) Directive 

The /O directive specifies options for controlling the processing of subsequent 
directives. 

Syntax 

/ O name , name , name 

1 2 n 

namej, name 2 and name n are the option names. A single /O directive can contain 
more than one name parameter. There can be any number of /O directives. 

The available options are: 

Name Use 

NAM informs J.INIT that the definitions in the patch file 

should be merged into the internal symbol table. This 
option should be specified once per single run. 

NHE informs J.INIT not to halt if patch errors are detected. 

If not specified, any patch error causes a halt. Entering 
//RUN continues processing. 

NPR informs J.INIT that a patch listing is not to be produced. 

SYM directs J.INIT to produce a listing of the internal symbol 

table. This specification should not be made in the first 
directive of a patch deck. 
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9.2.7 IP (Define a Patch Area) Directive 

The /P directive defines a temporary patch area or appends patches to the patch area 
defined by SYSGEN. It should be used during debugging. 


Syntax 

IP address value 

a patch area is defined starting at location address, value (word resolution) bytes long. 
If the extended mode is active in SYSGEN, the address must be in the first 16KW of 
memory. Since no attempt is made to protect this area, it should be some area of the 
resident image not used during debug operations. 

IP modname 

modname signals UNIT to determine the operating mode of a module and to generate 
a temporary patch area address according to the mode. This allows a patch area to be 
situated in the extended partition. 

IP CUR 

subsequent patches are added to those entered during a previous patch run 

9.2.8 /R (Return from the Patch Area) Directive 

The /R directive allows an unconditional branch back to the instruction plus one word 
produced by the last /G directive encountered. An offset can be specified to reserve a 
number of patch locations immediately following the branch back. 

Syntax 

/R 

an unconditional branch is inserted to the location plus one word containing the last 
branch generated by a /G directive 

/ R value 

an unconditional branch is inserted to the location plus one word containing the last 
branch generated by a /G directive value number of bytes of the patch area (word 
resolution) are reserved. This reserved area follows the generated branch. 

9.2.9 IF, U, /N (Conditional) Directives 

The /F and fT directives allow skipping the processing of other directives based on 
whether the directive statement is true (/T) or false (/F). Processing continues when a 
/N statement with the matching label is encountered. This creates a general patch file 
that attempts to modify only those modules included in the resident image. 
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Syntax 

IF name label 

if name is false or not defined in the symbol table, discontinue directive processing 
until a /N directive containing label is encountered 

U name label 

if name is true or defined in the symbol table, discontinue directive processing until a 
/N directive containing label is encountered 

U EXTDMPX modname label 
IF EXTDMPX modname label 

if the operation mode of modname is extended (JT) or nonextended (/F), directive 
processing is discontinued until a /N directive containing label is encountered 

IT MAPOUT label 
IF MAPOUT label 

if the current image is mapped out (JT) or mapped in (/F), directive processing is 
discontinued until a /N directive containing label is encountered 

/N label 

continues directive processing 

9.2.10 /$ (Enter a Value into the Patch Area) Directive 

The /$ directive inserts a value into the next free location of the patch area. 

Syntax 

/$ value 

value is inserted into the next free patch location 
/$ value R 

value is inserted, relative at the actual location. The value of $ is added to the address 
field of the value parameter for the actual location. 

/$ value -R 

the address field of value is subtracted from $ to form the actual address field of value. 
Value is then stored at the next free patch location. 

/$ name value 

value is inserted, relative to name. The value of name is added to the value and 
placed into the next free patch location. 
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9.2.11 /; (Comments) Directive 

The /; directive can be included on any patch directive as a delimiter. The total 
directive can be designated as a comment by the use of this directive. 

Syntax 

/; text 

9.3 Entry Conditions 

Calling Sequence: 

J.INIT is activated by SYSINIT at start-up. If the system is running, J.INIT can also 
be activated from TSM or OPCOM. To activate J.INIT from TSM, enter: 

TSM> J.INIT 

To activate from OPCOM, enter: 

? ? ACTIVATE J.INIT 

Patch processing is inhibited by setting control switch 2. 

9.4 Exit Conditions 

Return Sequence: 

M.EXIT Exit to MPX-32 

Registers: 

None 
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9.5 External References 

Abort Cases: 

Halt if error detected and the NHE option has not been specified. 

Output Messages: 

J.INIT produces an audit trail of all patches made unless the NPR option is 
specified. The information produced includes a source image of each patch, the 
actual location patched, the actual value stored, and the previous contents of the 
location. The number of remaining free patch locations is also listed. 

J.INIT can include error messages along with the audit trail listing. All error 
messages are preceded and/or followed by asterisks (******+). Possible error 
messages are: 

ERROR IN PREVIOUS PATCH -FIELD-rt 

n = number of the field containing the error (Jd = field 1) 

BASE TABLE OVERFLOW 

An attempt has been made to insert too many names in the internal 
symbol table (limit = 215 1Q ). 

PATCH AREA OVERFLOW 

An attempt has been made to insert too many patches in the area defined 
during SYSGEN or on the /P directive. 

DUPLICATE NAME - name 

An attempt has been made to insert the displayed name in the internal 
symbol table and it is currently in the table. 

END OF FILE ON patchfilename 

An attempt has been made to save the source image of a patch on the 
patch file and it is full (limit = 900 images). 

UNABLE TO ALLOCATE patchfilename 

If the patch file does not exist, J.PATCH attempts to create it. This 
message indicates that sufficient disk space was unavailable. 100 blocks 
are required. 

UNABLE TO ALLOCATE INPUT DEVICE 

The request to allocate the patch input device has been denied. 

PATCH ERRORS DETECTED 

Output at the end of the audit trail if any patch errors were detected. Also 
output to the console teletypewriter. 

EXTD/NONEXTD ADDRESS CONFLICT 

Indicates an extended patch exceeds the first 16KW of memory or an 
attempt was made to: place a nonbase patch in the extended area or place 
an extended patch in a nonbase area. 
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9.6 Examples 


Changing locations in a resident module 


/O NAM 


Get module description 

/C H.IOCS 

2154 CA803331 

See Note 1 

/C H.IOCS 

574 EC001003 R 

See Note 2 

/E 


End of patches 

Notes: 




(On 


1. Changes location 2154 of H . IOCS to a LI R5,X’3331\ 

2. Changes location 57 4 of H . IOCS to a BU to location 1003 of H.IOCS. 


Inserting into the patch area 


/O NPR NHE NAM 
/G H.REXS 100 
/$ CB050001 
/$ H.REXS F20005E5 
/$ EE000009 R 
/R 

/$ 00000000 
/O SYM 
/E 


See Note 1 
See Note 2 
See Note 3 
See Note 4 


List symbol table 
End of patches 


Notes: 

1. No print, no halt on error, get module definitions, save patches. 

2. Branch to the patch area from location 1 0 0 of H . REXS. 

3. Cl R6, 1 inserted in the next free location of patch area. 

4. BCF EQ,5E5 of H . REXS inserted. 
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9.7 Automatic Mounting of Public Volumes 

The last function of UNIT before exiting is the mounting of any volumes in the 
M. MOUNT file. 

See Chapter 10 of this volume for more information. 
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10.1 Introduction 

The system administrator (SA) implements and controls the system and resource 
protection facilities provided by MPX-32. System protection is concerned primarily 
with user access to the system. The system protection facilities are implemented by 
the M.KEY and M.PRJCT file. 

While not a direct function of the M.KEY and M.PRJCT files, resource protection 
facilities are not fully utilized unless these files are present and set up properly. 

An individual can be designated to have the responsibilities of initializing terminals, 
responding to system console messages as necessary for system operation, and 
initializing floppy disk media. 

Within a task, a privileged function can be performed for an unprivileged user with an 
SVC call. At the command processor level, this is done by allowing users to execute 
tasks that have the SA attribute. This attribute is established when the load module or 
executable image is created. 

The SA attribute permits the task to: 

• access resources without authorization checking 

• use the M.CALL macros (SVC 0) 

• mount public volumes 

• update the current system date and time 

• invoke the dual-processor shared-volume recovery task (J. UNLOCK) 

• set and override timeout and logon counters for security purposes 

The SA attribute is honored only if the load module or executable image file resides 
on the system volume and the owner of the file is SYSTEM. 

Any task executed with OWNER=SYSTEM also has the SA attribute. 

A task cataloged with SA can also specify the NODEBUG attribute to prevent 
unauthorized users from modifying the code. 

M.CALL macros can be used by SA tasks that are not privileged. Therefore, 
programs for such tasks should be written only by users with a thorough knowledge of 
the operating system. 
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The operating system also provides various optional services to control access to the 

system, accounting services, and user diagnostics. These services are invoked through 

the following system files: 

• M.KEY — Defines the set of authorized users of the system. Absence of this file 
prevents control of access to the system. This file is managed by the KEY 
program. 

• M.PRJCT — Defines the set of authorized project group names for resource access 
and accounting. This file is managed by J.PRJCT. 

• M.ACCNT — Records accounting information for terminal sessions and jobs 

• M.CNTRL — Provides automatic command file processing at logon 

• M.ERR — Contains system error explanations. This file can be modified to include 
user error messages. 

• M.MOUNT — Provides automatic mounting of specified volumes during IPL 


If the M.KEY, M.PRJCT, M.ACCNT, or M.ERR file is recreated, the new file is 
immediately effective. If control switch 4 is set at EPL, these four files are ignored 
while the system is running. 


10.2 M.KEY File 

The M.KEY file controls access to the system. 

Any user may logon to the system if the M.KEY file does not exist. All users who 
logon while the M.KEY file does not exist will be assigned the working directory 
@SYSTEM(SYSTEM). 

Once the M.KEY file has been created, only users established in this file may use the 
system. 

For each user in the file, the SA can specify the following attributes or restrictions: 

• password — a 1- to 16-character owner password required for logon 

• key — a 1 - to 8-character owner key required for logon 

• default project group name 

• default volume name 

• default working directory 

• default tab settings 

• flagwords — a series of directives that determine access to various parts of the 
system 


If a user has been assigned a default volume or default working directory that cannot 
be located when the user logs on to the system, the following message is displayed: 

* YOUR DIRECTORY IS UNAVAILABLE, PLEASE CHANGE DIRECTORY 

When this occurs, the user may only execute TSM directives. The user’s volume and 
directory name will be shown as asterisks by the $SHOW directive. 
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To prevent access to the M.KEY file by any user except SYSTEM, start up the system 
with control switch 4 set and create an M.KEY file under owner name SYSTEM using 
the following VOLMGR directive: 

VOL>CREATE 0SYSTEM ( SYSTEM) M . KEY ACCE=OW (R W A D) - 
VOL>ACCE=PR ( ) ACCE=OT ( ) ZERO=Y AUTO=N SIZE=N - 
VOL>REPLACE=Y 

Restart the system with control switch 4 reset. 

When these access rights are specified, users cannot change their password or key at 
logon and the PASSWORD and KEYWORD tasks do not function. 


10.2.1 Using KEY 

The system administrator attribute is required to run the KEY program. The primary 
file required to use KEY is an input file containing M.KEY information for each 
owner. 

M.KEY is supplied on the Master SDT with owner name SYSTEM. 

If the M.KEY file is recreated, the new file is immediately effective. If control switch 
4 is set at IPL, the M.KEY file is ignored while the system is running. 

The input file is prepared using the Edit STORE command. This file must be 
assigned to logical file code INP. Output is unblocked and automatically assigned to 
the system file M.KEY. 

When recreating the M.KEY file, valid owner names must be specified before logging 
off the system so that valid names exist for future logons. 

TSM>$ASSIGN INP TO FILENAME 
TSM>$KEY 


10.2.2 Directives 

KEY directives have one or more associated parameters. Some parameters can be 
preceded by a keyword and equal sign. Multiple parameters can be separated by TSM 
delimiters: spaces, commas, equal sign, and parentheses. 

Continuation of the directive to the next physical line is specified by a comma 
following the last parameter on the line. 

KEY directives are summarized below and described individually on the following 
pages. 
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Directive Description 


ADD 

CHANGE 

DEFAULTS 

DELETE 

LOG 

NEWFILE 

X 


authorizes a new user access to the system 

changes the attributes of an existing owner 

resets system defaults and establishes defaults for subsequent ADD 
commands 

removes an existing owner from the M.KEY file 
lists existing owners and all attributes except their key 
clears the M.KEY file of all existing entries 
indicates end of file and exits 


10.2.2.1 ADD Directive 

The ADD directive authorizes new users access to the system and specifies any 
restrictions applicable to them. 


Syntax 

ADD [OWNER=] name [ attribute ] 

[OWNER*]™™* 

name is the 1- to 8-character owner name 

[attribute] is one of the following attributes or restrictions to be in effect for the 
specified owner: 

PASSWORD*™™* 

name is the 1- to 16-character owner password associated 
with this owner. If this parameter is not specified, the default 
is no password. 

KEY =name 

name is the 1- to 8-character key associated with this owner. 
If not specified, the default is no key. For a list of restricted 
keywords refer to Table 10-1. 

V O LUME*™™* 

name is the 1 - to 1 6-character default volume name 
associated with this owner. If not specified, the default is 
SYSTEM. 

directory*™™* 

name is the 1- to 16-character default directory name 
associated with this owner. If not specified, the default is 
SYSTEM. 

PROJECT*™™* 

name is the 1- to 8-character default project group name 
associated with this owner. If not specified, the default is 
SYSTEM. 
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TAB S=tab [,tab] ... 

sets decimal tab positions to be associated with this owner. 
As many as 8 tab positions can be set. If not specified, 
default tabs are set at 10, 20, and 36. 

[FLAGS=]resrn'cf 

restrict is one of the following: 

ALL specifies all restrictions apply to this owner 
NONE specifies no restrictions apply to this owner 
ALLEXCEPT flist 

specifies all restrictions except the following 
listed key words (flist ) apply to this owner 

flist specifies the key words whose operations cannot 

be performed by this owner. See Table 10-1. 
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Table 10-1 

Restricted Keywords 


The following keywords disable the corresponding OPCOM directives: 


ABORT 

DISABLE 

ACTIVATE 

DISCONNECT 

BATCH 

DISMOUNT 

BREAK 

DUMP 

CONNECT 

ENABLE 

CONTINUE 

ESTABLISH 

DELETETIMER 

hold 

DEPRINT 

KILL 

DEPUNCH 

LIST 


MODE 

REQUEST 

MODIFY 

RESUME 

MOUNT 

SEARCH 

OFFLINE 

SEND 

ONLINE 

SETIIMER 

PURGE AC 

SNAP 

REDIRECT 

STATUS 

REPRINT 

SYSassign 

REPUNCH 

TIME 


When the following keywords are specified, the corresponding restrictions apply: 


Keyword Restriction 


CATPRIV 

CHANGEDEF 

MDT 

OWNERACC 

PRIORITY 

PRIVILEGE 
REMOVE 
RESTART 
USERFLAGS ( n ) 


Cannot catalog privileged programs. 

Cannot change working directory or project group. 

Cannot use the J.MDTI utility* 

Cannot access tasks with different owner name 

Cannot use the TSM $URGENT directive 

Cannot run privileged programs other than OPCOM 

Cannot use TSM $REMOVE directive 

Cannot use the TSM $RESTART directive 

Decimal number in range 0 to 255 for use by user for security. 

User programs may examine this number in bits 56 to 63 of 

T.ACCESS. 


When the following keywords are specified, the corresponding defaults apply: 
Keyword Default 

NOCOMMAND OPTION NOCOMMAND in TSM 

SEQQUENTIAL If more than one job is submitted by a TSM $SUBMIT 
directive, the jobs execute sequentially. If sequential 
execution is required for jobs run using a BATCH or RUN 
directive, S must be specified on the $JOB directive line. 

* The restrictions on this keyboard apply to only the KEY ADD directive. 
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10.2.2.2 CHANGE Directive 

The CHANGE directive changes the attributes of an existing owner of the system. 


Syntax 

CHANGE [OWNER=]name [ attribute ] 


[OWNER=] name 

name is the 1- to 8-character owner name 

[attribute] is one of the following attributes or restrictions to be in effect for the 
specified owner: 

PASSWORD=«a/ne 

name is the 1- to 16-character owner password associated 
with this owner. If this parameter is not specified, the default 
is no password. 


KEY =name 

name is the 1- to 8-character key associated with this owner. 
If not specified, the default is no key. For a list of restricted 
keywords refer to Table 10-1. 

V O LUME=name 

name is the 1- to 16-character default volume name 
associated with this owner. If not specified, the default is 
SYSTEM. 

D I RECT OR Y -name 

name is the 1- to 16-character default directory name 
associated with this owner. If not specified, the default is 
SYSTEM. 

PRO ]ECT=name 

name is the 1- to 8-character default project group name 
associated with this owner. If not specified, the default is 
SYSTEM. 

TABS=mfi [,tab] ... 

sets decimal tab positions to be associated with this owner. 
As many as 8 tab positions can be set. If not specified, 
default tabs are set at 10, 20, and 36. 

[FLAGS=]resrricr 

restrict is one of the following: 

ALL specifies all restrictions apply to this owner 
NONE specifies no restrictions apply to this owner 
ALLEXCEPT flist 

specifies all restrictions except the following 
listed key words (flist) apply to this owner 

flist adds the listed keywords to the existing 

restrictions for this owner. See Table 10-1. 
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10.2.2.3 DEFAULTS Directive 

The DEFAULTS directive establishes defaults for subsequent ADD directives. 

Each DEFAULTS remains in effect until the next DEFAULTS is specified. When the 
next DEFAULTS is specified, the default for any keyword not specified is the 
SYSTEM default. When more than one keyword default is to be defined for a group 
of users, all defaults must be specified with one DEFAULTS directive as shown in the 
example of directive usage. 

Syntax 

DEFAULTS [attribute] 

[attribute] are the following attributes or restrictions to be used as defaults for 
subsequent ADD directives: 

KEY =namename is the 1- to 8-character key associated with the specified 
owner. If not specified, the default is no key. For a list of 
restricted keywords refer to Table 10-1. 

V OLUME=«tfme 

name is the 1- to 16-character default volume name 
associated with the specified owner. If not specified, the 
default is SYSTEM. 

DIRECTORY=«tfm<? 

name is the 1- to 16-character default directory name 
associated with the specified owner. If not specified, the 
default is SYSTEM. 

PROlECT=name 

name is the 1- to 8-character default project group name 
associated with the specified owner. If not specified, the 
default is SYSTEM. 

TABS=wb [,tab] ... 

sets decimal tab positions to be associated with the specified 
owner. As many as 8 tab positions can be set. If not 
specified, default tabs are set at 10, 20, 36, and 64. 
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[FLAGS=]resrricf 

restrict is one of the following: 

ALL specifies all restrictions apply to the specified 
owner 

NONE specifies no restrictions apply to the specified owner 
ALLEXCEPT flist 

specifies all restrictions except the following 
listed key words (flist ) apply to the specified 
owner 

flist specifies the key words whose operations cannot 

be performed by the specified owner. See Table 
10 - 1 . 


10.2.2.4 DELETE Directive 

The DELETE directive removes an existing owner from the M.KEY file. 

Syntax 

DELETE [OWNERr] name 
[OWNER=] name 

name is the 1- to 8-character owner name 


10.2.2.5 LOG Directive 

The LOG directive lists existing owners and all attributes except their key. 


Syntax 

LOG [[OWNER=]«awc] 

[[OWNER=]mzme] 

name is the 1 - to 8-character owner name whose attributes are to be 
displayed. If not specified, all owners attributes are displayed. 


10.2.2.6 NEWFILE Directive 

The NEWFILE directive clears the M.KEY file of all existing entries. If present, it 
must be the first directive specified. 


Syntax 

NEWFILE 
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10.2.2.7 X Directive 

The X directive indicates end-of-file and exit. 


Syntax 

X 


10.2.3 Examples of Directive Usage 

NEWFILE 

ADD OWNER=S Y STEM V0LUME=S Y STEM DIRECTORY=SYSTEM 
DEFAULTS PROJECT=WORK TABS=7,12,24 FLAGS=NONE 
ADD OWNER=OWNl V0LUME=V0L1 DIRECT0RY=DIR1 
ADD OWNE R=OWN 2 VOLUME=VOL2 DIRECTORY=DIR2 
ADD OWNE R= OWN 3 

DEFAULTS VOLUME=TEST PROJECT=EXAM 
ADD OWNER=OWN4 KEY=0416 TABS=10, 25, 50 
CHANGE OWNER=OWN 3 VOLUME=VOL3 

ADD OWNE R=OWN 5 FLAGS=ALLEXCEPT MOUNT, SEARCH, PRIVILEGE, SEQUENTIAL 
ADD OWNER=OWN 6 

DEFAULTS VOLUME=TE ST DIRECTORY=DIR3 PROJECT=UTIL F LAGS =ABORT, HOLD, 

MOUNT, MODIFY, PRIVILEGE, PRIORITY, SEQUENTIAL TABS=9, 18,36 

ADD OWNER=OWN7 KEY=1205 

ADD OWNE R= OWN 8 KEY=1103 

ADD OWNE R= OWN 9 KEY=0613 

DELETE OWN 3 

LOG 

X 
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10.3 M.PRJCT File 

The M.PRJCT file contains the project group names that are valid to use with the 
TSM CHANGE PROJECT directive and are used by the accounting utility 
M.ACCNT. If a M.PRJCT file does not exist, any project group name is valid. If an 
M.PRJCT file does exist and an owner has a default project name not contained in 
M.PRJCT, no project name is extablished at logon. 

When using the accounting utility, project group names can be established for each 
owner name in two ways: 

1. Using the Volume Manager, an M.PRJCT file can be created under the owner 
SYSTEM as a nonextendible file that is not accessible by PROJECTGROUP or 
OTHER. The file should be zeroed. Eight entries per block can be placed in this 
file from an editor-created user file using the PROJECT program J.PRJCT. The 
output from the PROJECT program need not be assigned; output automatically 
goes to M.PRJCT unblocked. Only users with the system administrator attribute 
can use the PROJECT program. 

Example 

ENTER YOUR OWNERNAME : SYSTEM 
TSM>VOLMGR 

VOL>CREATE 0SYSTEM (SYSTEM) M. PRJCT AUTO=N ZERO=Y- 
VOL>ACCESS=PRO JECTGROUP () - 
VOL>ACCESS=OTHER ( ) SIZE=4 
VOL>X 

TSM>$ ASSIGN INP TO PFILE 
TSM>PROJECT 

2. Using the KEY utility, default project group names can be established for each 
owner name. 


Project group names can be changed by a user with the TSM SCHANGE PROJECT 
directive. When a project group name is changed, the account utility is terminated for 
the previous group name and initiated for the new group name. The change remains 
in effect until changed again or the user logs off the system. When the user logs on 
the system, default project group names are re-established. 


10.3.1 Using the PROJECT Program 

The primary file required to use PROJECT is an input file containing M.PRJCT 
information for each owner. 

This input file (filename in the following example) is prepared using the Edit STORE 
directive. It must be assigned to the logical file code INP. Output is unblocked and 
automatically assigned to the system file M.PRJCT. 

Example 

TSM>$ASSIGN INP TO filename 
TSM>$PROJECT 
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Only owners with the system administrator attribute can run the PROJECT program. 

If the M.PRJCT file is modified or recreated, the changed or new file does not 
become effective until the system is rebooted. If control switch 4 is set at BPL, the 
M.PRJCT file is ignored while the system is running. 


10.3.2 Directives 

Input to the PROJECT program is a series of directives that are summarized below 
and described in detail on the following pages. 

PROJECT directives have one or more associated parameters. Some parameters can 
be preceded by a keyword and equal sign. Multiple parameters can be separated by 
the normal TSM delimiters: spaces, commas, equal sign, and parentheses. 

Continuation of a directive to the next physical line is specified by a comma following 
the last parameter on the line. 

PROJECT directives are summarized below and described individually on the 
following pages. 


Directive Description 


ADD 

CHANGE 

DELETE 

LOG 

NEWFELE 

X 


authorizes a new project group name 

changes a key associated with a project group name 

removes a project group name from the PROJECT file 

lists existing project group names 

clears the M.PRJCT file of all existing entries 

indicates end-of-file and exits 


10.3.2.1 ADD Directive 

The ADD directive adds new project group names. 


Syntax 

ADD [PROJECT= ]pname [KEYsAey] 

[ P ROJECT=]pname 

pname is the 1- to 8-character project group name to be added 

[KEY=£ey] 

key is the 1- to 8-character key to be associated with this project group 
name 
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10.3.2.2 CHANGE Directive 

The CHANGE directive changes an existing key associated with a project group name 
or establishes a key with an existing project group name that does not have an 
associated key. A key cannot be deleted with this directive. If a key is to be deleted, 
the DELETE directive must be used to delete the project name; the ADD directive 
must then be used to re-establish the project name without a key. 

Syntax 

CHANGE [PROmCT=]pname [KEYstey] 

[ PROkECY=\pname 

pname is the 1- to 8-character project group name 

[KEYatey] 

key is the new 1- to 8-character key to be associated with this project 
group name 


10.3.2.3 DELETE Directive 

The DELETE directive removes an existing project group name from the PROJECT 
tile. 

Syntax 

DELETE [PR OJECT = \pname 

[PROJECT=\pname 

pname is the 1- to 8-character project group name to be deleted 


10.3.2.4 LOG Directive 

The LOG directive lists existing project group names. 

Syntax 

LOG [PROJECT=]p«am<? 

[PROTECT=]pname 

pname is the 1- to 8-character project group name whose authorization is to be 
listed. If not specified, all project group names are displayed. 
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10.3.2.5 NEWFILE Directive 

The NEWFILE directive clears the M.PRJCT file of all existing entries. If present, it 
must be the first directive specified. 


Syntax 

NEWFILE 


10.3.2.6 X Directive 

The X directive indicates end-of-file and exit. 


Syntax 

X 


10.3.3 Examples of Directive Usage 

NEWFILE 

ADD PROJECT=SYSTEM 

ADD PRO JECT=WORK 

ADD PRO JECT=EXAM 

ADD PRO JECT=UTIL 

ADD TEST 

ADD LANG KEY=XYZ 

ADD DOC KEY=JM 

CHANGE PROJECT=LANG KEY=DR 

CHANGE TEST KEY=CASE 

DELETE PROJECT=DOC 

ADD DOC 

LOG 

X 
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10.4 M.ACCNT File 

The job accounting program indicates elapsed time, CPU time, and IPU time for all 
jobs. The M.ACCNT file must be created by the Volume Manager under the owner 
name SYSTEM as a nonextendible zeroed file with read access by PROJECTGROUP 
and OTHER. Its size is determined by the need of the individual site. Its format is 
16 word entries in an unblocked 192W physical record. This file is where job 
accounting information is collected for use by TSM. 

Example 

ENTER YOUR OWNERNAME : SYSTEM 
TSM>VOLMGR 

VOL>CREATE 0SYSTEM ( SYSTEM) M . ACCNT AUTO=N ZERO=Y SIZE=100- 
VOL>ACCESS=PROJECTGROUP (R) - 
VOL>ACCESS=OTHER (R) 

The M.ACCNT file is created as a nonextendible file on volume SYSTEM and 
directory SYSTEM. PROJECTGROUP and OTHER have read access. As many as 
1200 entries can be specified. 

If the M.ACCNT file is recreated, the new file does not become effective until the 
system is rebooted. If control switch 4 is set at DPL, the M.ACCNT file is ignored 
while the system is running. 

Default project group names for accounting purposes can be established with the 
M.KEY utility. 

Data collected by the accounting program can be retrieved with the OPCOM LIST 
command. Refer to the OPCOM chapter in Reference Manual Volume II. 

The format of M.ACCNT file entries follows. 
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0 7 8 15 16 23 24 31 

Word 0-1 
2-3 
4-5 
6-7 
8-9 
10 
11 
12-13 
14-15 


Notes: 

1. Owner name - the 1- to 8-character ASCII owner name associated with the job 

2. Project - the 1- to 8-character ASCII alphanumeric project name or number 
associated with the job 

3. Date - the ASCII numeric date associated with the job 

4. Logon time - the ASCII numeric time of day on the 24-hour clock the user 
signed on the system 

5. Elapsed time - the total time (24-hour clock) the user was signed on the system 
in ASCII 

6. Raw CPU time - the actual number of 38.4 microsecond intervals of CPU time 
for the job (unformatted equivalent of CPU time) in binary 

7. Raw IPU time - the actual number of 38.4 microsecond intervals of IPU time for 
the job (unformatted equivalent of IPU time) in binary 

8. Origin - the ASCII task pseudonym for the accounting session 


Owner name (1- to 8-character ASCII). See Note 1. 
Project (1- to 8-character ASCII). See Note 2. 

Date ( mmlddlyy ) (ASCII). See Note 3. 

Logon time ( hh/mm/ss ) (ASCII). See Note 4. 
Elapsed time ( hh:mm:ss ) (ASCII). See Note 5. 

Raw CPU time (Binary). See Note 6. 

Raw IPU time (Binary). See Note 7. 

Origin (1- to 8-character ASCII). See Note 8. 
Reserved 
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10.5 M.CNTRL File 

The M.CNTRL file is a TSM command file selected by J.TSM automatically when a 
user logs on. If the M.CNTRL file exists, it must be located in the system directory. 

As the M.CNTRL file can contain TSM directives and comments, it can establish 
defaults, send messages, and further restrict access to the TSM environment. 

Example 

EDT>COL 

1 . NOTE LOG ON AT 

2. ! TIME 

3 . <cr> 

EDT>STO M.CNTRL SYS 

This causes the time and date to be automatically displayed when a user logs on the 
system. NOTE indicates the line is a comment line. 

Notes: 

Attempts to break out of the M.CNTRL file are ignored. 

Errors in M.CNTRL file processing result in normal error processing for control files. 
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10.6 M.ERR File and xc.ERR Files 

The M.ERR file contains system abort codes and messages, and should not be 
modified. The xc.ERR files contain messages for unbundled products and user abort 
codes. For example, FT.ERR contains FORTRAN 77+ abort messages. 

The abort code format is: 
xxnn 

x is an alphabetic character 

n is a numeral 

The file SJ.XX.ER is provided on the SDT and can be modified with other abort 
messages by using the Text Editor (EDIT). When an abort code cannot be found in 
the M.ERR file, J.TSM appends .ERR to the abort code’s prefix. Using the resulting 
name, J.TSM attempts to allocate a file in the system directory. If allocation occurs, 
the file is searched for the error code. 

10.6.1 Creating xx.ERR File 

Modify SJ.XX.ERR as follows: 

1. Enter EDIT. 

2. Use file SJ.XX.ER. 

3. Modify the prefix at label STARTX. 

Example: 

STARTX PREFIX C'MD' MEDIA ERRORS 

4. Remove the example messages. 

• 5. Add messages using C strings. 

6. After each message, call macro MSG xx,nn where xx is the prefix specified at 
STARTX; nn is the abort number in ascending order. 

Example (starts in the second column): 

DATA C' ERROR ENCOUNTERED READING SYC FILE' 

MSG LM, 01 

DATA C' ERROR ENCOUNTERED WRITING TO SLO' 

MSG LM, 03 

7. Save the completed file. 

Example: 

ED T> SAVE 0SYSTEM (SOURCE) SJ.XV.ER 
(xx is the prefix specified at STARTX) 
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8. Exit EDIT. 

9. Submit the following job stream to install the new error file: 

$ JOB NEWERR OWNER 
$ASSIGN SI TO SJ.xr.ER BLOCK=Y 


$ ASSIGN BO TO OJ.xr.ER BLOCK=Y 

$OPTION 1 4 

$ASSEMBLE 

$AS SGO TO OJ.XC.ER BLOCK=Y 

$IFF PATH=QSYSTEM^ (SYSTEM) JCJC . ERR GO 


$NOTE ERROR - ATTEMPT MADE TO WRITE 
$GOTO END 
$DEFNAME GO 
$ CATALOG 
CATALOG XX . ERR 
$DEFNAME END 
$EOJ 
$$ 

Abort messages are immediately in effect without rebooting the system. 

10.7 Terminal/ALIM/ACM Initialization (INIT) 

Terminal/ ALIM/ ACM initialization is the process of defining hardware characteristics 
of TSM and non-TSM devices. For purposes of this section, TSM devices are defined 
as terminals, device type code X'OC’ TY, connected through model 91 10 ALIM or 
8510, 8511, or 8512 Eight-line Asynchronous Communications controllers. Non-TSM 
devices are defined as devices other than terminals; the device type code is not TY, 
but the device can be connected through these same controllers. 

Hardware characteristics are typically defined by a user-created system file named 
LOGONFLE, or in its absence, by a set of system supplied defaults. Characteristics 
include baud rate, parity, and half or full duplex. The wakeup (ring) character for all 
terminals is also defined as a hardware characteristic. 

Initialization of a TSM device is handled automatically when a system is installed or 
restarted, regardless of the existence of a LOGONFLE. Initialization of a non-TSM 
device requires a LOGONFLE entry defining the characteristics of the non-TSM 
device and the keyword NOTSM. 

Although the IOP console is normally treated as a TSM device, it is not initialized by 
INIT. 


(SJ.xr.ER is the file previously 
saved in Step 7 by the Text Editor 
(EDIT)) 

(OJ.xx.ER must be created 
prior to this assignment) 


(xr is the prefix entered in Step 3. 
This text ensures that an existing 
abort file code is not destroyed). 

OVER EXISTING ABORT FILE 


(xc is the prefix entered in Step 3) 
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10.7.1 TheLOGONFLE 

The LOGONFLE must contain the logon records in blocked, uncompressed format. 
The Editor STORE directive can create this file. 

The form of a LOGONFLE is shown below. LOGONFLE must contain a record for 
the wakeup character definition and one record for each device definition. Only 
characters 1 to 72 of each record are interpreted. An asterisk (*) in column 1, from 
Record 2 on, indicates the line is a comment line. A semicolon (;) or an exclamation 
point (!) in any position of a line, from Record 2 on, permits comments to follow on 
the line. 

Record 1: wakeup 

Record 2: ccaa field field ... 

EOF 

wakeup is a 2-digit hexadecimal number defining the character which must be 
typed at interactive terminals to start a logon sequence. 

ccaa is the channel number and subaddress of the device to initialize. Must be 
supplied in LOGONFLE for each device. If LOGONFLE was not 
created, the system default is to initialize all addresses defined at 
SYSGEN as device type TY with the system default parameters. If 
channel cc exists, but no device is connected to subaddress aa, J.TINIT 
will mark the device online but note them as failed (dead) devices; if cc 
does not exist, J.TINIT will mark the device offline and dead. 

field is a 1- to 8-character keyword, (the first 4 characters are significant,) 

describing the characteristics of a device. Fields can be entered in any 
order and can be duplicated. Fields are evaluated left to right; later 
entries overrule earlier entries. See Table 10-2 for valid keywords and 
their significance to ALIM and 8-Line Async devices. If a LOGONFLE 
is not created, all devices defined as device type TY at SYSGEN are 
initialized with the system default parameters (see section 2.2 of this 
chapter). Before LOGONFLE is created, J.INIT or J.TINIT will mark all 
TY devices online, but note them as failed devices (dead terminals). 

TSM devices not included in the LOGONFLE once it is created retain the 
system default parameters and remain online and dead. 
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Table 10-2 

LOGONFLE Field Keywords 


Category 

Keyword 

ALIM 

8-Line Async 

Baud Rate 

19200 

not used 

19200 bps 


9600 

9600 bps 

9600 bps 


7200 

7200 bps 

7200 bps 


4800 

4800 bps 

4800 bps 


3600 

3600 bps 

3600 bps 


2400 

2400 bps 

2400 bps 


2000 

not used 

2000 bps 


1800 

1800 bps 

1800 bps 


1200 

1200 bps 

1200 bps 


900 

900 bps 

not used 


600 

600 bps 

600 bps 


300 

300 bps 

300 bps 


150 

150 bps 

150 bps 


134 

134.5 bps 

134.5 bps 


110 

110 bps 

110 bps 


75 

75 bps 

75 bps 


50 

50 bps 

50 bps 


EXT 

external rate 

not used 

Parity 

ODD 

odd parity 

odd parity 


EVEN 

even parity 

even parity 


NONE 

no parity 

no parity 

Duplex 

HALF 

half duplex 

half duplex 


FULL 

full duplex bit set in 
UDT 

full duplex 

full duplex 

Stop Bits 

SI 

1 stop bit 

1 stop bit 


S1.5 

1.5 stop bits 

1.5 stop bits 


S2 

2 stop bits 

2 stop bits 

Character Size 

8 

8-bit characters 

8 -bit characters 


7 

7-bit characters 

7-bit characters 


6 

6-bit characters 

6-bit characters 


5 

5-bit characters 

5-bit characters 

Miscellaneous 

GRAP 

graphic device 

graphic device 


MODEM 

sets modem bit in UDT 

sets modem bit in UDT 


REMOTE 

sets dial-up bit in UDT 

sets dial-up bit in UDT 


NOTSM 

not a TSM device 

not a TSM device 


EMIT 

initialization data present 

initialization data present 


L GC-nnn 

max number of logon 
attempts allowed 

max number of logon 
attempts allowed 


LGT =sss 

max time allowed at 
logon prompt in seconds 

max time allowed at 
logon prompt in seconds 


TMO —mmm 

max wait time for a 
terminal read in minutes 

max wait time for a 
terminal read in minutes 
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Note: System-wide default values can be set for LGC, LGT, and TMO by specifying 

LGC, LGT, and TMO in a comment line that occurs before the first terminal 
definition. Refer to the Sample LOGONFLE section in this chapter. 


10.7.2 Security Counters 

MPX-32 provides the system administrator with controls that protect the system from 
unauthorized access to maintain system integrity. These controls are counters, 
specified in the LOGONFLE, that limit access as follows: 

• the number of logon attempts allowed 

• the time spent when logging on 

• the amount of time that a terminal can remain I/O inactive 

The following section discusses these counters and provides an example of then- 
usage. 


10.7.2.1 Logon Attempt Counter 

The logon attempt counter limits the number of logon attempts. This counter can vary 
from terminal to terminal. The system administrator specifies the number of logon 
attempts in the LOGONFLE as follows: 

LGC=/l«fl 

nnn is the number of logon attempts, 0 to 255, allowed before the terminal is 

marked offline. If nnn is 0, there is no limit on the number of logon 
attempts. The default is 0. 

For more information about the LOGONFLE, refer to section 10.8.1 in this chapter. 

To change the logon attempt counter, the system administrator must change the 
LOGONFLE. To override the counter until the next terminal initialization, enter the 
following: 

TSM>LOGCNT termaddr nnn 

termaddr specifies the address of the terminal. If termaddr is not specified, 
LOGCNT uses the value established as the system default in the 
LOGONFLE. 

nnn specifies the number of logon attempts, 0 to 255, allowed. The default is 

0 . 

If a terminal is marked offline, the system administrator can enable the terminal with 
the TSM SENABLE command. See Chapter 1 of the MPX-32 Reference Manual 
Volume II for more information. 
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10.7.2.2 Logon Timeout Counter 

The logon timeout counter limits the time that can be spent at a logon prompt. If this 
counter expires, the terminal is marked offline and the logon attempt counter is 
incremented. The system administrator specifies the logon timeout counter in the 
LOGONFLE as follows: 

~LGT=sss 

sss specifies the number of seconds, 0 to 255, that a terminal waits at a logon 

prompt before being logged off. The default is 0. 

To change the logon timeout counter, the system administrator must change the 
LOGONFLE. To override the counter until the next terminal initialization, enter the 
following: 

TSM>LOGTIME termaddr sss 

termaddr specifies the address of the terminal. If termaddr is not specified, 
LOGTIME uses the value established as the system default in the 
LOGONFLE. 

sss specifies the number of seconds, 0 to 255, that the terminal waits at a 

logon prompt. The default is 0. 


10.7.2.3 Terminal Timeout Counter 

The terminal timeout counter limits the time that a terminal can remain I/O inactive. 
The system administrator specifies the terminal timeout counter in the LOGONFLE as 
follows: 

TMO=mmm 

mmm specifies the number of minutes, 0 to 999, that a terminal can be I/O 
inactive before it is logged off. If mmm is 0, there is no limit. The 
default is 0. 

To change the terminal timeout counter, the system administrator must change the 
LOGONFLE. To override the counter until the next terminal initialization, enter the 
following: 

TSM>TERMOUT termaddr mmm 

termaddr specifies the address of the terminal. If termaddr is not specified, 
TERMOUT uses the value established as the system default in the 
LOGONFLE. 

mmm specifies the number of minutes, 0 to 999, that a terminal can be I/O 
inactive before it is logged off. If mmm is 0, there is no limit. The 
default is 0. 

If a terminal is marked offline, the system administrator can enable the terminal with 
the TSM $ENABLE command. See Chapter 1 of the MPX-32 Reference Manual 
Volume II for more information. 
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10.7.2.4 Security Counters Example 

The following is an example that sets the logon attempt counter, the logon timeout 
counter, and the terminal timeout counter. 


05 JRING IN CTRL/E) 

* LGC=5 LGT=45 TMO=120 ! system defaults 


7EA0 

7EA1 

7EA2 

7EA3 

7EA4 

7EA5 

7EA6 

7EA7 


19200 FULL EVEN 7 SI 

9600 FULL EVEN SI EXON 

19200 FULL EVEN 7 S1WXON TMO=60 

9600 FULL EVEN 7 SI WXON 

19200 FULL EVEN 7 SI LGT=120 

19200 FULL EVEN 7 SI 

19200 FULL EVEN 7 SI WXON 

1200 FULL NONE 6 WXON REMOTE LGC=3 


!no changes 
! no changes 

•Sets Term Timeout Ctr 

! no changes 

!sets logon timer 

!no changes 

!no changes 

! sets logon counter 
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10.7.3 

Syntax 

ccaa 


ALIM Terminal Record Syntax and Defaults 


[baud] [HALF I FULL] [ECHO I NOECHO] [parity] [charsize] [stopbits] [GRAP] 
[MODEM] [REMOTE] [NOTSM] [INIT value] [LGC=ww] [LGT=m] [TMO -mmm] 

ccaa is the channel and subaddress of the device. 

[baud] is the baud rate: 9600, 7200, 4800, 3600, 2400, 1800, 1200, 900, 600, 

300, 150, 134, 110, 75, 50, or EXT. If EXT is entered, the baud rate is 
set externally. The default is 9600 baud. 

[HALF I FULL] 

is the half or full duplex operation. The default is HALF. 

[ECHO I NOECHO] 

specifies characters are or are not to be echoed by the computer as they 
are received. The default is ECHO for FULL duplex or NOECHO for 
HALF duplex. 

[parity] is ODD, EVEN, or NONE. The default is EVEN. If NONE is specified, 
the serial character is smaller due to the absence of the parity bit. 

[charsize] is the character size: 5, 6, 7, or 8. The default is 7. 

[stopbits] is the number of stop bits: SI, S1.5, or S2. The default is SI. 

[GRAP] sets the graphic bit in the UDT. GRAP specifies that standard message 
processing should be suppressed for this device. The default is not 
graphic device. 

[MODEM] sets modem bit in UDT. The default is not set. 

[REMOTE] sets dial-up bit in UDT. The default is not set. Also, sets switched 
mode. The default is private mode. 

[NOTSM] specifies a non-TSM device. The default is TSM device. 

[INIT value] 

indicates the presence of hexadecimal initialization data. Five words of 
hexadecimal value in the ALIM initialization format. See section 
10.7.3.1, ALIM Initialization Format. 


[LGC -nnn] 

nnn specifies the number of logon attempts, 0 to 255, allowed before the 
terminal is marked offline. If nnn is 0, there is no limit on the number of 
logon attempts. The default is 0. 

[LGT=sss] sss specifies the number of seconds, 0 to 255, that a terminal waits at a 
logon prompt before being logged off. The default is 0. 

[TMO -mmm] 

mmm specifies the number of minutes, 0 to 999, that a terminal can 
remain I/O inactive. 
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The following table shows possible ALIM terminal configurations and their resulting 
operations. 


SYSGEN Device 

LOGONFLE 

LOGONFLE 

Resulting 

Directive, FULL 

FULL/HALF 

ECHO/NOECHO 

Terminal 

Option Specified 

Option Specified 

Option Specified 

Operation 

yes 

full 

echo 

half, echo 

yes 

full 

noecho 

full, noecho 

yes 

half 

echo 

half, echo 

yes 

half 

noecho 

half, noecho 

no 

full 

echo 

half, echo 

no 

full 

noecho 

half, noecho 

no 

half 

echo 

half, echo 

no 

half 

noecho 

half, noecho 


10.7.3.1 ALIM Initialization Format 

Fields containing an asterisk (*) are required; the remaining fields are optional. If not 
specified, the default is OFF. 


0 7 8 15 16 23 24 31 


Word 1 

Channel time-out value*. See Note 1. 

2 

Mode *. See Note 2. 

Baud *. See Note 3. 

Format. See Note 4. 

Zero 

3 

Code. See Note 5. 

STX. See Note 6. 

EXT. See Note 7. 

CHAR A. 
See Note 8. 

4 

CHARB. See Note 9. 

CHARC. 
See Note 10. 

CHAR D (ring). 
See Note 11. 

SI. See 
Note 12. 

5 

S2. See Note 13. 

Zero 


Notes: 


1. Bits 0-31 specify the channel time-out value in seconds. For example, 
X’0000005A’ gives a time-out value of 90 seconds. 


10-26 


System Administrator Services 




Terminal/ALIM/ACM Initialization (INIT) 


2. Mode bits are defined as follows: 


Bits 

0-1 


4-5 


6-7 


Description 

Stop bits (SB) are interpreted as follows: 


BitO 


Bit 1 


SB 


0 0 invalid 

0 1 1 stop bit 

1 0 1.5 stop bits 

1 12 stop bits 

Parity selection (PS) is interpreted as follows: 

Bit Setting Description 


0 odd parity 

1 even parity 

Parity enable (PE) is interpreted as follows: 
Bit Setting Description 


0 disable parity 

1 enable parity 

Character length (CL) is interpreted as follows: 


Bit 4 


Bit 5 


CL 


0 

0 

1 

1 


0 

1 

0 

1 


5 bits 

6 bits 

7 bits 

8 bits 


Baud rate factor (BRF) is interpreted as follows: 
Bit 6 Bit 7 BRF 


0 

0 

1 

1 


0 

1 

0 

1 


synch mode 
IX 
16X 
64X 
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3. Baud rate bits are defined as follows: 



Bits 

8-11 

12-15 


Description 

Zero 

With 16X selected in bits 6-7, baud rate is interpreted as follows: 

Bit 12 Bit 13 Bit 14 Bit 15 Baud Rate 


0 

0 

0 

0 

0 

0 

0 

1 

1 

1 

1 

1 

1 

1 

1 

0 


0 

0 

0 

1 

1 

1 

1 

0 

0 

0 

0 

1 

1 

1 

1 

0 


0 

1 

1 

0 

0 

1 

1 

0 

0 

1 

1 

0 

0 

1 

1 

0 


1 

0 

1 

0 

1 

0 

1 

0 

1 

0 

1 

0 

1 

0 

1 

0 


50 

75 

110 

134.5 

150 

300 

600 

900 

1200 

1800 

2400 

3600 

4800 

7200 

9600 

EXT 


4. Format bits are defined as follows: 


Bits 

16~ 

17 

18 
19 


20 


21 


22-23 


Description 

enable hardware ring detection 

enable break detection 

inhibit 1ms RTS off delay 

full or half duplex interpreted as follows: 

Bit Setting Description 

0 half duplex (HDX) 

1 full duplex (FDX) 

Switch indicator is interpreted as follows: 
Bit Setting Description 

0 private 

1 switched line 

Must be set for types 103 and 212 modems 
Bit Setting Description 

0 switched 

1 constant 

Zero 


V. ,..- y 
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5. Code bits are defined as follows: 

Bits Description 

0-3 zero 

4-7 Code bits (4-bit hexadecimal value) are interpreted as follows: 

Value Description 

0 no action 

1 terminate on CHAR A 

2 terminate on CHAR A or B 

3 terminate on CHAR A, B, or C 

4 terminate on CHAR A* followed by B* 

5 terminate on CHAR A* followed by B* 

followed by C* 

* These characters must be different from STX, ETX, ring, or 
strip characters 


6. Start of text character (STX) bits are defined as follows: 

Bits Description 

8 Action bit interpreted as follows: 

Bit Setting Description 

0 recognize character 

1 inhibit character recognition 

9-15 Start of text character (STX) to be recognized (7-bit ASCII 

character). The character must be different from ETX, strip, 
ring, and terminate characters. 


Upon recognition, unblind mode is set causing this character and subsequent 
characters to be passed to memory. Blind mode, which deletes characters or 
blocks of characters, is set by either a receive blind order or the recognition of an 
ETX character during a receive blind order. 
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7. End of text character (ETX) bits are defined as follows: 

Bits Description 

16 Action bit interpreted as follows: 

Bit Setting Description 

0 recognize character 

1 inhibit character recognition 

17-23 End of text character (ETX) to be recognized (7-bit ASCII 
character). The character must be different from STX, strip, 
ring, and terminate characters. 

This character is recognized only during a receive blind order. Upon recognition, 
blind mode is set which blocks characters from being passed to memory. 

However, character recognition is still in effect for the STX and the ABC 
characters. 

8. Termination CHAR A bits are defined as follows: 

Bits Description 

24 zero 

25-31 termination CHAR A (7-bit ASCII character) which must be different 

from STX, ETX, ring, and strip characters. 

Recognition of CHAR A causes channel end if the character is recognized in the 
manner specified in bits 0-7. 

9. Termination CHAR B bits are defined as follows: 

Bits Description 

0 zero 

1-7 termination CHAR B (7 -bit ASCII character) which must be different 

from STX, ETX, ring, and strip characters. 

Recognition of CHAR B causes channel end if the character is recognized in the 
manner specified in Word 3, bits 0-7. 

10. Termination CHAR C bits are defined as follows: 

Bits Description 

8 zero 

9-15 termination CHAR C (7-bit ASCII character) which must be different 

from STX, ETX, ring, and strip characters. 


Recognition of CHAR C causes channel end if the character is recognized in the 
manner specified in Word 3, bits 0-7. 
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1 1 . Ring interrupt CHAR D bits are defined as follows: 

Bits Description 

16 Action bit interpreted as follows: 

Bit Setting Description 

0 recognize character 

1 inhibit character recognition 

17-23 Ring interrupt CHAR D bits (7-bit ASCII character) which must be 
different from STX, ETX, strip, and terminate characters. 

When recognized, and no I/O is in progress, a ring interrupt is 
generated. Ring character reporting is enabled and disabled in 
the same manner as breaks. 

12. Strip character (SI) bits are defined as follows: 

Bits Description 

24 Action bit interpreted as follows: 

Bit Setting Description 

0 recognize character 

1 inhibit character recognition 

25-31 Strip character (SI) bits (7 -bit ASCII character) which must be 

different from STX, ETX, ring, and terminate characters. 


The SI character is to be stripped from an incoming data stream. The character 
is unconditionally removed from the input buffer. The character cannot have 
been previously specified for a control function. 

13. Strip character (S2) bits are defined as follows: 

Bits Description 

0 Action bit interpreted as follows: 

Bit Setting Description 

0 recognize character 

1 inhibit character recognition 

1-7 Strip character (S2) bits (7 -bit ASCII character) which must be different 

from STX, ETX, ring, and terminate characters. 


The S2 character is to be stripped from an incoming data stream. The character 
is unconditionally removed from the input buffer. The character cannot have 
been previously specified for a control function. 


MPX-32 Reference Volume III 


10-31 



Terminal/ALIM/ACM Initialization (INIT) 


Example 

The following example shows a dial-in type 103 modem interface to an ALIM with 
one stop bit, even parity, parity enabled, 7-bit character length, baud rate factor of 
16X, and data rate of 300 baud. 

2003 MODEM REMOTE INIT 00001518 7A06CC00 0180800D 80800580 80000000 
00001518 

time-out of 90 seconds 

7A06CCOO 

7 1 stop bit, even parity, parity enabled 

A 7 bit character baud rate factor (16X) 

0 6 300 baud rate 

C enable ring and break detection 

C switched line 

00 must be zero 

0180800D 

01 terminate on CHAR A 

80 STX characters - no action 

80 ETX characters- no action 

0D CHAR A 0D=carriage return 

80800580 

8 0 CHAR B - no action 

80 CHAR C - no action 

05 ring-in character is <ctrl>E (X’05’) 

80 strip character 1 - no action 

80000000 

80 strip character 2 - no action 

000000 must be zero 
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10.7.4 

Syntax 

ccaa 


ACM/MFP Controller Record Syntax and Defaults 


[baud] [HALF I FULL] [ECHO I NOECHO] [ parity ] [charsize] [ stopbits ] 

[REMOTE] [NORTS] [MODEM] [GRAP] [NOTSM] [RXON] [WXON] 
[RHWF] [WHWF] [RDTR] [RRTS] [INIT value] [CXR=«] [LGCwi/w] 
[LGT=5is] [TMO=mmm] 


ccaa is the channel and subaddress of the device. 

[baud] is the baud rate: 19200, 9600, 7200, 4800, 3600, 2400, 2000, 1800, 1200, 

600, 300, 150, 134, 110, 75, or 50. If not specified, the default is 9600 
baud. 

[HALF I FULL] 

is the half or full duplex operation. If not specified, the default is HALF. 
Refer section 10.8.4.3, True Full-Duplex Operation for the ACM. 

[ECHO I NOECHO] 

specifies characters are or are not to be echoed by the computer as they 
are received. If not specified, the default is ECHO for FULL duplex or 
NOECHO for HALF duplex. 

[parity] is ODD, EVEN, or NONE. If not specified, the default is EVEN. If 
NONE is specified, the serial character is smaller due to the absence of 
the parity bit. 

[charsize] is the character size: 5, 6, 7, or 8. If not specified, the default is 7. 

[stopbits] is the number of stop bits: SI, S1.5, or S2. If not specified, the default is 
SI. 

[REMOTE] sets dial-up bit in UDT. If not specified, the default is not set. 

[NORTS] resets the ready to send signal (RTS) after device initialization. This 
option allows software control of a peripheral switch controller in 
configurations with a controller present. 

[MODEM] sets modem bit in UDT. If not specified, the default is not set. Also sets 
modem bit for ACE parameters. The default is no modem. 

[GRAP] specifies graphic device. If not specified, the default is not graphic 
device. 

[NOTSM] specifies a non-TSM device. If not specified, the default is TSM device. 

[RXON] specifies software read flow control (XON/XOFF). If not specified, the 
default is no software read flow control. If this option is selected for a 
terminal, NOECHO should be specified so the terminal can be used in 
local echo mode. This avoids line contention caused by echoplex. 
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[WXON] specifies software write flow control (XON/XOFF). If not specified, the 
default is no software write flow control. 

XON - no timeout value on writes 
XOFF - 75 second timeout value on writes 

[RHWF] specifies hardware read flow control (DTR). This parameter cannot be 
specified if either RXON or WXON has been specified. If not specified, 
the default is no hardware read flow control. If this option is selected for 
a terminal, NOECHO should be specified. This avoids line contention 
caused by echoplex. 

[WHWF] specifies hardware write flow control (DTR). This parameter cannot be 
specified if either RXON or WXON has been specified. If not specified, 
the default is no hardware write flow control. If this option is selected for 
a terminal, the NOECHO parameter should be specified. This avoids line 
contention caused by Echoplex. 

[RDTR] specifies the DTR line is used if RXON has been requested. This is the 
default, and it overrides RRTS if both are specified. 

[RRTS] specifies the RTS line is used if RXON has been requested. 

[CXR=«] n specifies the number of seconds to wait for carrier before J.TSM resets 
DTR, causing the modem to go on hook. Valid values for n are 1-255. 
The value specified by n must include delays introduced by the modem. 
The use of this option will also cause a 2 second delay at logon time 
before transmitting the logon banner. 

[INIT value ] 

indicates the presence of hexadecimal initialization data, value is a 1- 
word hexadecimal value in the 8-line asynch initialization format. See 
ACM/MFP Initialization Format below. 


[LGC =nnn] 

nnn specifies the number of logon attempts, 0 to 255, allowed before the 
terminal is marked offline. If nnn is 0, there is no limit on the number of 
logon attempts. The default is 0. 

[LGT=m] sss specifies the number of seconds, 0 to 255, that a terminal waits at a 
logon prompt before being logged off. The default is 0. 

[TMO —mmm\ 

mmm specifies the number of minutes, 0 to 999, that a terminal can 
remain I/O inactive. 


10-34 


System Administrator Services 



Terminal/ALIM/ACM Initialization (INIT) 


10.7.4.1 ACM/MFP Initialization Format 


0 1 2 3 4 5 6 7 8 9 10 11 12 


15 16 


23 24 


31 


Word 1 

D 

M 

F 

P 

P 

S 

C 

D 

C 

W 

D 

Baud 

Wake-up 

Zero 


u 

R 

P 

S 

E 

B 

L 

C 

W 

D 

L 

rate 

character 



p 

1 















e 















X 















Bit Description 

0 Full or half duplex bit is defined as follows: 

0 full duplex 

1 half duplex 

1 Modem ring (MR) bit is defined as follows: 

0 disable 

1 enable 

2 Forced parity (FP) bit is defined as follows: 

0 normal parity as defined 

1 force parity to one if odd; force parity to zero if even 

3 Parity selection (PS) bit is defined as follows: 

0 odd parity 

1 even parity 

4 Parity enabled (PE) bit is defined as follows: 

0 disable parity 

1 enable parity 

5 Stop bit (SB) defined is as follows: 

0 1 stop bit 

1 2 stop bits or 1 .5 stop bits for 5 character length 

6-7 Character length (CL) is defined as follows: 

Bit 6 Bit 7 CL 


0 

0 

1 

1 


0 

1 

0 

1 


5 bits 

6 bits 

7 bits 

8 bits 


ACM — Delta carrier (DC) bit is defined as follows: 

0 disable attention on delta carrier 

1 enable attention on delta carrier 
MFP — zero 

ACM — Character write (CW) bit is defined as follows: 

0 disable wait for the end of the last character write 

1 enable wait for the end of the last character write 

MFP — zero 


MPX-32 Reference Volume III 


10-35 




Terminal/ALIM/ACM Initialization (INIT) 


10 Wake-up detection (WD) bit is defined as follows: 

0 allow wake-up character detection 

1 inhibit wake-up character detection 

1 1 Diagnostic loop (DL) bit defined as follows: 

0 reset diagnostic loop 

1 set diagnostic loop 

12-15 Baud rate bits defined as follows: 


Bit 

12 

Bit 

13 

Bit 

14 

Bit 

15 

ACM 

Baud 

rate 

MFP 

Baud 

rate 

0 

0 

0 

0 

50 

75 

0 

0 

0 

1 

75 

110 

0 

0 

1 

0 

110 

134.5 

0 

0 

1 

1 

134.5 

150 

0 

1 

0 

0 

150 

300 

0 

1 

0 

1 

300 

600 

0 

1 

1 

0 

600 

1200 

0 

1 

1 

1 

1200 

2000 

1 

0 

0 

0 

1800 

2400 

1 

0 

0 

1 

2000 

4800 

1 

0 

1 

0 

2400 

1800 

1 

0 

1 

1 

3600 

9600 

1 

1 

0 

0 

4800 

19200 

1 

1 

0 

1 

7200 

38400 

1 

1 

1 

0 

9600 

External clock is 16X 

1 

1 

1 

1 

19200 

External clock is IX 


16-23 8-bit wake-up character 

24-31 Must be zero 
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10.7.4.2 Example 

The following example shows a dial-in modem interface to an ACM 8-line 
asynchronous with one stop bit, even parity, parity enabled, full duplex, 7-bit 
character length, and modem ring enabled. 

7EC0 MODEM REMOTE INIT 5A050500 
5A050500 

5 full duplex, enable modem ring, normal parity as defined, 

even parity 

A parity enabled, one stop bit, 7-bit character 

05 300 baud rate 

05 ring-in character is <ctrl>E (X’05’) 

0 0 must be zero 


10.7.4.3 True Full-Duplex Operation for the ACM 

The ACM device can be used for true full-duplex operation. The device must have 
been SYSGENed using the device directive’s FULL parameter. This creates two 
UDT’s per full-duplex subchannel: one for the read sub-channel and one for the write 
subchannel. The write subchannel subaddress is the read subchannel address plus 
X’8’; for example, a subchannel address of 7E00 derives a write subchannel address 
of 7E08. The device must be initialized as NOECHO (local echoplex) to avoid I/O 
contention with the write subchannel. After the device is initialized, it is in full- 
duplex, single -channel mode; all read and write I/O is performed through the read 
subchannel. 

To set the device to full-duplex, dual-channel mode, the TSM OPTION UNQUIET 
directive must be used. Dual-channel I/O reads are performed on the read subchannel; 
writes are performed on the write subchannel. Dual-channel mode is also entered by 
assigning the read and write subchannels separately, as if OPTION UNQUIET were in 
effect, and issuing an M.RELP (SVC 1,X’27’) before any I/O is performed. I/O is 
then performed through the FCB associated with the appropriate subchannel. To reset 
to the single-channel mode, use the M.RESP (SVC 1,X’26’) service. 
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10.7.5 Sample LOGONFLE 

05 

*LGC=3 

*LGT=60 

*TMO=60 


7EA0 19200 FULL 

7EA1 9600 FULL NONE 8 SI WXON REMO NOTSM 
7EA7 HALF MODEM REMOTE EVEN 300 
2000 9600 FULL EVEN 7 


WAKEUP CHARACTER WRITE 
! SYSTEM-WIDE MAX LOGON 
ATTEMPT OF 3 

! SYSTEM-WIDE MAX LOGON TIMER 
OF 60 SECONDS 
! SYSTEM-WIDE MAX TERMINAL 
TIMER OF 60 MINUTES 
! DEFAULTS FOR OTHER VALUES 
! SAMPLE SERIAL PRINTER 
! DIAL-UP LINE 
! ALIM 


REMOTE sets dial-up bit in UDT. The default is not set. 

MODEM sets modem bit in UDT. The default is not set. Also 

sets modem bit for ACE parameters. The default is no modem. 

EVEN even parity is used. 

7 7 bit data is used. 

full full duplex operation. 

NOTSM specifies a non-TSM device. The default is TSM device. 

HALF half duplex operation. 

8 8 bit data is used. 

SI specifies 1 stop bit is required. 

WXON device uses software write flow control (XON/XOFF). 

LGC=3 specifies a system-wide default logon count of 3 

LGT=60 specifies a system- wide default logon timer of 60 seconds 

TMO=60 specifies a system-wide default terminal timer of 60 minutes 

The following table shows the ACM configurations possible and their resulting 
operations. 


SYSGEN Device 

LOGONFLE 

LOGONFLE 

Resulting 

Directive, FULL 

FULL/HALF 

ECHO/NOECHO 

Terminal 

Option Specified 

Option Specified 

Option Specified 

Operation 

yes 

full 

echo 

half, echo 

ye's 

full 

noecho 

full, noecho 

yes 

half 

echo 

half, echo 

yes 

half 

noecho 

half, echo 

no 

full 

echo 

half, echo 

no 

full 

noecho 

half, noecho 

no 

half 

echo 

half,echo 

no 

half 

noecho 

half,noecho 
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10.8 Using INIT 

INIT is a TSM command. LOGONFLE is assigned for input by default. 

Syntax 

tsm>$INIT [ ccaa\ 

[ ccaa] specifies the appropriate channel and subaddress (hexadecimal) of a 
specific device to be reinitialized. The record from LOGONFLE that 
matches the channel and subaddress reinitializes the device. 

If no device is specified, INIT uses the current version of LOGONFLE to reinitialize 
all devices that are currently free to allocate. 

10.9 INIT Errors 

INIT generates the following error messages: 

ATTEMPT TO MAKE TSM DEVICE A NON TSM DEVICE, ADDR=CCaa 
The NOTSM keyword is specified in LOGONFLE for a TSM device. 

DEVICE NOT PRESENT ADDR=CCaa 

The specified device is not plugged into the CPU. 

DEVICE NOT TERMINATED ADDR=COW 

The specified device is not plugged in on device end of line. 

INVALID LOGON COUNTER SUPPLIED. DEFAULT IS 0. 

When setting up the defaults, an invalid character was entered for nnn in 
LGC =nnn. The default becomes 0. 

INVALID LOGON COUNTER SUPPLIED. DEFAULT USED. 

When using a terminal-specific counter, an invalid character was entered for nnn 
in LGC=n«/j. The system default is used. 

INVALID LOGON TIMEOUT VALUE SUPPLIED. DEFAULT IS 0. 

When setting up the defaults, an invalid character was entered for sss in 
LGT=sss. The default becomes 0. 

INVALID LOGON TIMEOUT VALUE SUPPLIED. DEFAULT USED. 

When setting up a terminal specific timeout value, an invalid character was 
entered for sss in LGT=m. The default becomes 0. 
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INVALID NON TSM DEVICE TYPE CODE, ADDR =ccaa 

Valid non-TSM device type codes are X’07’ (CD) through X’OB’ (PT) and 
X’OD’ (CT) through X’ 1 A’ (U9). 

INVALID TERMINAL TIMEOUT VALUE SUPPLIED. DEFAULT IS 0. 

When setting up the defaults, an invalid character was entered for mmm in 
TMO=mmm. The default becomes 0. 

INVALID TERMINAL TIMEOUT VALUE SUPPLIED. DEFAULT USED. 

When setting up a terminal specific timeout value, an invalid character was 
entered for mmm in TMO=mmm. The default becomes 0. 

M . ASSN DENIAL, NO LOGON FILE DEFAULT USED 

A file named LOGONFLE is not on the system. Default parameters have been 
set. Non-TSM devices are not initialized. 

M . ASSN DENIAL, ADDR=ccoa 

The device at the specified channel and subaddress is in use and cannot be 
initialized. 

NO UDT ENTRY FOR ADDR=craa 

The specified device is not SYSGENed. 

NON TSM DEVICE WITHOUT NOTSM IN LOGONFLE, ADDR =ccaa 

A non-TSM device is specified in LOGONFLE without the NOTSM keyword. 

ON ADDRESS ccaa, FIELD UNIDENTIFIED : xxxxxxxx 

The string xxxxxxxx is not a valid keyword for a characteristic. 

TERMINAL SET-UP COMPLETE 
Initialization complete. 

WARNING, LOGON COUNTER VALUE TOO LARGE. CAPPED TO 255 ATTEMPTS 
The value nnn in LGC =nnn was larger than 255. 

WARNING, LOGON TIME VALUE TOO LARGE. CAPPED TO 255 SECONDS. 
The value sss in LGT=,m was larger than 255. 

WARNING, TERMINAL TIMEOUT VALUE TOO LARGE. CAPPED TO 999 MINUTES. 

The value mmm in TMO=mmm was larger than 999. 
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10.10 System Console Messages 

Some system messages and operations pertain to the system console, and not to 
terminals running OPCOM, for example: 

• mount and dismount messages for magnetic tape 

• abort messages and codes for tasks running in the real-time environment 

• I/O error conditions that can either be corrected offline with I/O resumed or aborted 

Displaying these messages on the console assumes a central location of configured 
system hardware, including the system console, the CPU, printers, and tape units. 
User tasks can also send messages to the system console. 

10.10.1 Information Messages 

Commands or responses to prompts at the system console always take precedence 
over messages sent to the console. The maximum output string that cannot be 
interrupted for a message is 72 characters. 


10.10.2 Action Messages 

If a system message requires operator intervention and reply, the condition noted must 
be addressed. The operator enters a reply and terminates it with a carriage return. For 
example, 

*CR7800 INOP : R, A? R 

A card reader is not operating. The operator fixes it and responds R and a carriage 
return to resume. Input continues. 


10.10.3 Terminal Messages 

The terminal user receives only the OPCOM messages that pertain to directives issued 
from that terminal. 
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10.11 Floppy Disk Media Initialization (J.FORMF) 

All IOP floppy disks must be properly formatted before they can be used on the 
operating system. 

To format a floppy disk, type J.FORMF at the TSM prompt. The following message 
is displayed: 

J.FORMF— SPECIFY FORMAT :MODEO/MODE1/QUIT (REPLY 0, 1, OR Q) : 

If 0 (MODEO) is entered, the floppy disk is formatted as double density, 256 bytes 
per sector. The first physical sector of all tracks starts at hexadecimal 0 and ends at 
hexadecimal 19. 

If 1 (MODE1) is entered, the floppy disk is formatted as double density, 256 bytes 
per sector. The first physical sector of all tracks starts at hexadecimal 1 and ends at 
hexadecimal 1A. MODE1 formatting allows data files to be transported to other 
computer systems that expect the physical sectors to begin at hexadecimal 1 and end 
at hexadecimal 1A. MODE1 is only supported on systems containing a Model 8031 
Line Printer/Floppy Disk Controller. 

If Q (QUIT) is entered, control returns to TSM and the floppy disk is not formatted. 

The default mode selection should be MODEO and must be MODEO if data files are 
to be transported to another Encore computer containing either a Model 8030 or 8031 
Line Printer/Floppy Disk Controller. 

The default device for J.FORMF is device address FL7EF0. To override the default, 
specify the following assign directive at the TSM prompt before J.FORMF is 
activated: 

$ASSIGN FL TO DEV=FLxtXX BLO=N 
xxxx is the drive device address to be used by J.FORMF. 
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10.12 M.MOUNT File 

The M.MOUNT file automatically mounts volumes at IPL. It can be used to mount 
both public and nonpublic volumes. (A nonpublic volume requires a logical mount by 
subsequent users to access the resources on that volume). Use of the nonpublic mount 
should be determined by the specific needs of the system applications. 

The M.MOUNT file directive syntax is the same as the OPCOM MOUNT directive. 
Refer to the OPCOM section in the MPX-32 Reference Manual, Volume II. The file 
must be stored unnumbered on the SYSTEM volume. 

Examples 

EDT>COL 

1. MOUNT ATLAS 04 ON DM0804 OPTION=PUBL 

2. MOUNT TB02 ON DM0802 OPTION=PUBL 


5 . <ret> 

EDT>STO M.MOUNT SYS UNN 

If desired, an asterisk (*) can be used in the volume name field. This causes the 
volume on the specified drive to be mounted, regardless of its name. 

At system initialization, a mount message is displayed for each volume in the file. If 
an ABORT (A) is entered to any message, an attempt is made to MOUNT any 
remaining volumes. 
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10.13 Operator Intervention Inhibit 

When operator intervention is inhibited, all prompts normally displayed on the system 
console are suppressed and the following defaults are in effect: 


Prompt 

system date/time 

swap volume channel and subaddress 
mount messages - formatted volumes 
dual-port volume cleanup confirmation* 
wait I/O request retry 
invalid port ID specification* 
dual-port volume mount request verification 
for an allocated port* 


Default 

more recent date/time recorded by 
JDTSAVE or last system volume mount 
system volume 
ready 
no 

abort (DPO) 
port zero 
continue 


The prompts marked by an asterisk (*) apply only when a dual-processor shared 
volume is mounted. If the default responses to these prompts are not the desired 
responses, unreliable file system management can result. 

After system initialization, wait I/O request retry prompts remain inhibited. When a 
wait I/O retry is requested, a message is displayed on the system console specifying 
the inoperable device and the request is aborted. 

Mount messages are not inhibited after system initialization. The SYSGEN or 
OPCOM MODE directive inhibits mount messages after system initialization. If 
mount messages are inhibited and a device is not ready when J.MOUNT issues a 
mount request, the request is repeated approximately 60 seconds later. If the device is 
still not ready after the second request, the mount request is aborted. 

When operator intervention is inhibited and an attempt is made to boot a master 
system image, operator intervention inhibit is overridden and an operator must 
respond to the prompts. 


10.14 System Date/Time Backup Program (J.DTSAVE) 

The System Date/Time Backup Program (J.DTSAVE) is a privileged, nonresident 
system program. J.DTSAVE records the current date and time to the system volume 
at regular intervals. The intervals are established by the SYSGEN directive DTSAVE. 
If operator intervention is inhibited, the system date and time are initialized to either 
the last date and time recorded by JDTSAVE or the date and time of the last system 
volume mount, whichever is more recent. Entering a chronologically accurate date 
increases the reliability of file system management. J.DTSAVE is activated by the 
SYSGEN and OPCOM ACTIVATE directives. 
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10.15 System Shutdown 


MPX-32 offers a system shutdown capability to increase reboot performance. The 
system administrator can request the following types of shutdown: 

Shutdown type Description 

immediate forced System shuts down immediately, without 

waiting for user and task activity to 
end. 


timed forced System waits a specified time for user 

and task activity to end, then shuts 
down when this activity ends or time 
expires. 

indefinite System waits indefinitely for all user 

and task activity to end before it 
shuts down. 


Shutdown ends with a system halt or, if requested, with an online restart. This restart 
can be to the default system image or to a specified image. 

The system administrator requests a shutdown by using either the J.SHUTD task or a 
shutdown macro. These differ as follows: 

• J.SHUTD task performs a shutdown without notifying users that a shutdown is in 
progress. This task deallocates system resources, requests volume dismounts, and 
halts or restarts the system. 

• A shutdown macro provides an interface to users and application tasks during 
shutdown. It informs users when a shutdown is in progress, ends application tasks 
specified in the macro, and calls J.SHUTD to perform the shutdown. A sample 
macro, SHUTDOWN, is included on the Master SDT and can be customized for 
any system. 

Note: To shutdown a system with active users, we recommend using a shutdown 

macro. Use the J.SHUTD task only when the system has no active users. 


10.15.1 Using J.SHUTD 

For a timed or indefinite shutdown, J.SHUTD requests the dismount of all volumes 
and sends a message to tasks holding resources on the system volume. When all 
system volume resources are deallocated, J.SHUTD marks the volume as quiescent 
and physically dismounts it if the current image is the default. Other volumes are 
physically dismounted as their resources are deallocated. When the dismounts 
complete and the system volume is quiescent, or when time expires, J.SHUTD halts 
the system. If a restart is requested, J.SHUTD restarts to the default or specified 
image. 

For an immediate forced shutdown, J.SHUTD halts the system instantly, without 
waiting for volume dismounts or for the system volume to be quiescent. If requested, 
J.SHUTD restarts the system. 
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Syntax 

J.SHUTD [[TIME=]w] [RESTART [image]] 

[TIME=]ii specifes the number of seconds for J.SHUTD to wait for system activity 
to end before forcing a shutdown. Specify 0 to shutdown immediately. 
Omit the option to initiate an indefinite shutdown. 

RESTART requests an online restart following shutdown. If this option is omitted, 
shutdown ends in a system halt. 

image is the file name of the system image to restart. When an image is 

specified, MPX-32 cleans up the system volume. If omitted, the default 
image is used. 

After J.SHUTD is called, system shutdown cannot be canceled. 


10.15.2 Shutdown and Volume Cleanup 

MPX-32 cleans up the system volume after shutdown in the following cases: 

• shutdown is forced before the system volume dismounts 

• the image requested for restart is not the current image 

• the current image before shutdown is not the default image 

• a different image is made the default image without restarting 


10.15.3 SHUTDOWN Macro 

The shutdown macro, SHUTDOWN, notifies users of a pending shutdown and 
initiates this shutdown by calling J.SHUTD. This macro can be modified to set how 
often it sends a message to users, which tasks it deallocates or removes before 
shutdown, and what value it passes to the J.SHUTD TIME option. The macro can 
pass up to four parameters to J.SHUTD. These parameters must correspond to the 
J.SHUTD syntax or an error results. 

Shutdown can be canceled while the macro is running by using a $REMOVE 
command to remove the job. 

10.15.4 Using SHUTDOWN 

The SHUTDOWN macro can be run either in batch or interactive mode. To avoid 
tying up a terminal during shutdown, we recommend you batch the macro or set the 
terminal page size to zero ($PAGESIZE 0) before running the macro interactively. 
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Syntax 

BATCH SHUTDOWN [[TIME=] ss] [REST ART[=irazge] ] 

[TIME=]ss specifies the number of seconds before forcing a shutdown. Specify 0 for 
an immediate forced shutdown. Omit a value to initiate an indefinite 
shutdown. The macro uses ss in calculating when to call J.SHUTD. 

RESTART requests a restart following shutdown. The macro passes this parameter to 
J.SHUTD. 

image specifies the filename of the system image to restart. The macro passes 
this parameter to J.SHUTD. 

To run the macro interactively, omit the BATCH keyword from the syntax above. 

The macro can also be batched from a program through the TSM procedure call 

service (M.TSMPC/M_TSMPC). Refer to the MPX-32 Reference Manual, Volume I, 

Chapter 6 or 7 for information on the M.TSMPC or M_TSMPC service. 


10.15.5 Modifying the SHUTDOWN Macro 

To control the time between signals to users, the macro uses the PAUSE task. Each 
call to the task has the following syntax: 

PAUSE n 

n is the number of seconds the task pauses until the next signal to users. 

Each call to PAUSE specifies a value ( n ) for the number of seconds to pause. The 
macro uses smaller n values as the time remaining to shutdown decreases. These n 
values can be modified throughout the macro to increase or decrease the pause 
between signals. 

To determine when to call J.SHUTD to perform the shutdown, the macro uses the 
ACTIME constant. This constant is the number of seconds (less than 60) that the 
macro passes to the TIME option of J.SHUTD. The macro runs for ss minus ACTIME 
seconds before calling J.SHUTD. When the macro is batched with ss less than or 
equal to 60, it resets ACTIME to ss. This ACTIME constant can be modified to 
increase or decrease the value passed to the J.SHUTD TIME option. 

The macro signals users based on ACTIME and the macro’s TIME=ss option as 
follows: 

• If ss is omitted, the macro informs users that an indefinite shutdown is in progress. 

It calls J.SHUTD to handle the shutdown and the macro ends. 

• If 55 is 0, the macro informs users that the system is shutting down immediately. It 
calls J.SHUTD to halt the system and the macro ends. 

• If 55 is 60 seconds or less, the macro informs users that the system is shutting down 
in less than 1 minute. It calls J.SHUTD and passes 55 to the J.SHUTD TIME 
option. 
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• If ss is less than 1 hour and greater than 1 minute, the following table applies: 
Minutes until shutdown Macro signals every 


1-3 

1 minute 

4-5 

3 minutes 

6-20 

5 minutes 

21-60 

15 minutes 


When 1 minute remains, the macro sends a final message and pauses for 60 seconds 
minus ACTIME, then calls J.SHUTD. 

• If ss is greater than 1 hour and less than 2 hours, the macro informs users that the 
system is shutting down in the given time and it pauses for ss minus 1 hour. It then 
sends another message informing users of the time remaining to shutdown. When 1 
hour remains, the table above applies. 

• If ss is greater than or equal to 2 hours, the macro informs users that the system is 
shutting down in the given time and it pauses for 1 hour plus the number of 
minutes and seconds in the given time. For example, if TIME=7300 seconds (2 
hours, 1 minute, 40 seconds), the macro pauses for 1 hour, 1 minute, 40 seconds 
before sending another message. The macro then sends a message every hour until 
1 hour remains and the table above applies. 


10.15.6 Error Messages 

The following messages are written to LFC ERR: 

J.SHUTD: SYSTEM ADMINISTRATOR ATTRIBUTE IS REQUIRED 

J.SHUTD: IMAGE NAME MUST BE 0 TO 8 CHARACTERS 

J.SHUTD: TOO MANY ARGUMENTS OR INVALID ARGUMENT SUPPLIED 

The following messages are written to the console only: 

J.SHUTD: DISMOUNT REQUEST TO VOLUME name RETURNED WITH RMwt 

name is the name of the volume that J.SHUTD requested to dismount 

nn is a REMM abort code. Refer to Appendix C for a list of these abort 
codes or use the TSM $ERR directive. 

Note: J.SHUTD returns an RM14 error indicating that dismount is 

pending if the volume still has resources allocated. 

J.SHUTD: RUN REQUEST TO RESTART RETURNED FROM M.SRUNR 
WITH STATUS VALUE mm 

mm is a status value returned from the call to M.SRUNR. Refer to the 

M.SRUNR system service in Chapter 6 of MPX-32 Reference Volume 
I for a list of these status values and their meaning. 

If a restart or request for restart fails, halt and reboot the system. 
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The SHUTDOWN macro sends the following messages to owner SYSTEM: 

SHUTDOWN: INVALID ARGUMENT SPECIFIED. JOB TERMINATED. 

SHUTDOWN: TIME ARGUMENT IS INVALID. JOB TERMINATED. 
SHUTDOWN: IMAGE NAME GIVEN IS INVALID. JOB TERMINATED. 

Note: If the SHUTDOWN macro parameters are entered incorrectly, TSM 

issues an INVALID PARAMETER TYPE message. 


10.16 Swap Scheduler Control Options 

The swap scheduler processes entries in the memory request queue (MRQ). It 
provides memory allocation and swap scheduling for individual memory requests. So 
that the swap scheduler can function according to the requirements of a system, the 
following swap scheduler options can be set by the system administrator: 

1. Swapper algorithms 

2. Wait state ordering 

3. Wait state swap-on priority only 

4. Call back swap-on priority only 

5. User set swap-on priority only flag 

6. User set swap inhibit flag 

7. Swap thrash control 

8. Task group outswap limits 


To set or reset an option, edit the Swap Option File (SJ.SWAPR2). SJ.SWAPR2 
contains instructions on how to edit the file. After the file is edited, it must be 
resaved as SJ.SWAPR2. Then, the JCL file, JJ.A.SWP, must be run to catalog the 
swapper load module (J.SWAPR). After J.SWAPR is cataloged, the system 
administrator must restart the system to incorporate the modified swap scheduler into 
the operating system. 

If SJ.SWAPR2 is not modified, the swap scheduler options are defaulted so that 
J.SWAPR performs similar to MPX-32 Revision 3.2C. To revert to swapping that is 
similar to MPX-32 Revision 3.2C after the swap option file has been edited, re-edit 
the SJ.SWAPR2 file and set all options to their default settings. 

Swap-on priority only (SOPO) means that a task will be outswapped only when 
memory is required for an equal or higher priority task, regardless of the task’s state. 
If swap-on priority only is not in effect, a higher priority task in any wait state can be 
outswapped for a lower priority task that is ready to run. If the outswapped higher 
priority task changes to a ready-to-run state too soon, the task is inswapped again 
causing delays and reducing system performance. 
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10.16.1 Swapper Algorithms 


There are two swap scheduler algorithms: 

Algorithm 1 — determines if sufficient swappable memory is available for the 
memory requestor before selecting an outswap candidate. If Algorithm 1 is set and 
the requested memory is not available, the swap scheduler suspends until the next 
memory scheduler event. 

Algorithm 2 — outswaps a task without determining if sufficient swappable memory 
will be available for the memory requestor. If no memory is outswapped for one 
second, the outswapped tasks are eligible to be inswapped. When there has not been 
an inswap for one second, the cycle can repeat. This algorithm assumes that the 
highest priority task on the memory request queue will receive its required memory. 

To set this option, edit the Method section of SJ.SWAPR2. 


10.16.2 Wait State Ordering 

The Wait State Ordering option determines the order that the swap scheduler searches 
the queues for swap candidates. The Swap Option File (SJ.SWAPR2) contains a list 
of queues that can be arranged in any order. If this list is not modified, the swap 
scheduler searches the list as follows: 


Queue Order 

HOLD first 

SUSP 

RUNW 

SWDV 

SWDC 

SWSR 

SWSM 

SWLO 

SWFI 

MRQ 

ANYW 

SWGQ 

SWTI 

SWIO 

SWMP last 


To change the list, edit the Wait State Search section of SJ.SWAPR2. 
Caution: All 15 wait states must appear in the list. 
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10.16.3 Wait State Swap-on Priority Only (SOPO) 

The Wait State Swap-on Priority Only (SOPO) option allows any of the 15 wait states 
to be Swap-on Priority Only. This option allows all tasks in the designated wait state 
to be SOPO. If this option is not set, tasks are not designated SOPO because of their 
wait state. 

To set this option, edit the Wait State Search section of SJ.SWAPR2. 


10.16.4 Call Back Swap-on Priority Only (CB.SOPO) 

The Call Back Swap-on Priority Only (CB.SOPO) option determines whether a task is 
SOPO when callback is pending for a no-wait message request or a no-wait run 
request. If this option is not set, the task is not SOPO. 

To set this option, edit the CB.SOPO section of SJ.SWAPR2. 


10.16.5 User Set Swap-on Priority Only Flag (US.SOPO) 

The User Set Swap-on Priority Only Flag (US.SOPO) option allows a privileged task 
to set a flag bit in the DQE (DQE.USPO). This allows the task to be SOPO until the 
bit is reset. If this option is not set, DQE.USPO is ignored. 

To set this option, edit the US.SOPO section of SJ.SWAPR2. 


10.16.6 User Set Swap Inhibit Flag (US.SWIF) 

The User Set Swap Inhibit Flag (US.SWIF) option allows a privileged task to set a 
flag bit in the DQE (DQE.USWI). This specifies the task as ineligible for 
outswapping until the bit is reset. If this option is not set, the swap inhibit bit 
(DQE.USWI) is ignored. 

To set this option, edit the US.SWIF section of SJ.SWAPR2. 


10.16.7 Swap Thrash Control 

Swap thrashing may occur when tasks that are frequently changing between the 
ready-to-run and wait states are competing for memory. Thrashing causes these tasks 
to be swapped between memory and the swap file on the disk as their state changes. 
To reduce swap thrashing and improve system performance, the user can set 
SWAPDUTY or SWAPPERI. 
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SWAPDUTY is a value between 0 and 100 that indicates the percentage of time that 
the swap scheduler can actively swap tasks. If the swap scheduler activity is greater 
than SWAPDUTY, J.SWAPR processes only swap-on priority only tasks. If the 
SWAPDUTY is 100, there is no thrash control and all tasks are swapped according to 
wait state. If the SWAPDUTY is 0, only SOPO tasks are swapped. If most of the 
tasks are SOPO and the swap scheduler is very active, thrashing may occur. 

SWAPPERI is a value between 2 and 64 seconds. If set to a value less than 2, 
SWAPPERI defaults to 2 seconds. If set to a value greater than 64, SWAPPERI 
defaults to 64 seconds. 

The percentage of the swap activity is constantly being monitored by the system. If 
the swap activity is greater than the SWAPDUTY, only SOPO tasks are swapped. If 
the percentage of swap activity is less than the SWAPDUTY, all tasks are swapped on 
a wait state basis. 

If this option is not set, the system default is no thrash control and SWAPDUTY is 
measured every 2 seconds per megabyte of memory. 

To set this option, edit the Thrash Control section of SJ.SWAPR2. 


10.16.8 Task Group Outswap Limits 

The Task Group Outswap Limits option provides performance predictability for task 
swapping by controlling memory availability on a task group basis. This is 
accomplished by assigning tasks to task groups and specifying the outswap limit (the 
amount of memory eligible for outswap) for each task group. 

To improve system throughput and reduce the chance of memory deadlock, the Task 
Group Outswap Limits option can override the outswap limit. This is done only when 
the memory requestor and outswap candidate are in the same task group. In this 
situation, the Task Group Outswap Limits option reallocates memory from the 
outswap candidate to a different task in the task group. It then outswaps the outswap 
candidate and inswaps the memory requestor. 

To specify the Task Group Outswap Limits option, complete the following: 

• Configure the system for type S memory with the SYSGEN SIZE directive. For 
more information, refer to Chapter 7, the System Generation (SYSGEN) chapter, in 
this volume. 

• Set the Swapper Algorithms option for Swap Algorithm 2. 

• Set the task group outswap limit in the outswap limit table by editing SJ.SWAPR2. 

• Assign a task group identification number to the task with the Cataloger 
CATALOG directive. For example, the following CATALOG directive statement 
assigns TASKA to task group five: 

CATALOG TASKA TGID=5 

Cataloger then stores the task group identification number, in this case five, in the 
load module preamble (byte 0 of word 45) for the task. 
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Notes: 

A task can be assigned to only one task group. 

If the TGID parameter is not specified in the CATALOG directive, the task group 
identification number defaults to 0. 

Up to 16 task groups can be assigned. 

System deadlock can occur if memory requirements cannot be met because the 
outswap limits force a task to become unswappable. 

10.16.8.1 Errors 

If there is not enough memory for an inswap of the highest priority task on the 
memory request queue (MRQ), an error occurs. The following message displays on 
the terminal: 

**** WARNING: SWAPPER ANOMALY HAS OCCURRED. 

NOT ENOUGH MEMORY FOUND FOR THE HIGHEST PRIORITY TASK IN THE MRQ. 

This message displays on the terminal at timed intervals 

that can be set with the 

MSGTIME parameter in SW.SWAPR2. 


1 0.1 7 Multiprocessor Recovery Task (J. UNLOCK) 

J.UNLOCK is the multiprocessor recovery task. In a multiprocessor system, 
J.UNLOCK allows a processor to recover and continue processing when another 
processor goes offline. Resource locks, assign counts, and user counts owned by the 
offline processor are removed from the shared volumes by the online processor. 

J.UNLOCK is a resident, privileged task. It is activated by an OPCOM UNLOCK 
directive or by J. MOUNT when a multiprocessor shared volume is mounted. When 
the last multiprocessor shared volume is dismounted from the system, J.UNLOCK 
deactivates. 
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10.18 Shadow Memory 

After the shadow memory board is installed and shadow memory is configured, the 
run-time performance improves for a task that uses shadow memory. 

MPX-32 supports three shadow memory boards which can be configured from address 
0 to the end of memory. The 128 KB board must be configured at multiples of 16 
map blocks, the 512KB board at multiples of 64 map blocks, and the 4MB board at 
multiples of 512 map blocks. The following shadow memory configurations are 
supported. 

• a single processor (EPU or CPU) with a single region of shadow memory. See 
Figure 10-1. 

• two processors (IPU and CPU) with a single region of shadow memory. The 
regions must have the same starting and ending addresses and be shadowed by an 
equal number of shadow memory boards on both processors. See Figure 10-2. 

• two processors (IPU and CPU) with two nonoverlapping shadow memory regions. 
The starting addresses of both regions are different and the number of shadow 
memory boards for each processor can be unequal. See Figure 10-3. 



and a Single Region of Shadow Memory Using 128 KB Shadow Board 
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BYTE 

ADDRESS 


ONE SHADOW MEMORY BOARD PER PROCESSOR 


SECOND SHADOW MEMORY BOARDS (IF INSTALLED) 


S OR E 

CLASS MEMORY 
(OPERATING SYSTEM) 


H3 CLASS MEMORY 



S CLASS MEMORY 


Figure 10-2 

Shadow Memory Configuration with Two Processors 
and a Single Region of Shadow Memory Using 128 KB Shadow Board 


S OR E 
CLASS MEMORY 
(OPERATING SYSTEM) 


PROCESSOR ONE S SHADOW MEMORY BOARD 

PROCESSOR ONE’S SECOND SHADOW MEMORY BOARD 
(IF INSTALLED) 

PROCESSOR TWO'S SHADOW MEMORY BOARD 

PROCESSOR TWO’S SECOND SHADOW MEMORY BOARD 
(IF INSTALLED) 


HI CLASS MEMORY 


H2 CLASS MEMORY 



S CLASS MEMORY 


Figure 1 0-3 

Shadow Memory Configuration with Two Processors 
and Two Regions of Shadow Memory using 128 KB Shadow Board 
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Configurations not supported are: 

• processors with multiple shadow boards that are not jumpered over a contiguous 
region of physical memory 


A shadow memory board can be jumpered to physical address zero which causes the 
resident portion of MPX-32 to be shadowed. 

A processor’s shadow memory is assigned to a contiguous region in physical memory; 
shadow memory is not supported for noncontiguous regions of physical memory. 

There are three shadow memory classes: 

HI Shadow memory installed for processor 1. 

H2 Shadow memory installed for processor 2. 

H3 Processor 1 and 2 have equal amounts of shadow memory, and are both 
jumpered to the same addresses. 

These classes specify the memory types used in the SYSGEN TYPE directive. The 
TYPE directive can reserve shadow memory for tasks that request shadow memory. 

Notes: 

The Processor Select Switch determines which processor is the CPU and which is the 
IPU. MPX-32 matches the processors to the CPU or IPU and determines if shadow 
memory is present. 

If shadow memory is not reserved, tasks that require S class memory can allocate 
shadow memory. This can cause tasks that require the shadow memory to wait for 
shadow memory. If a task requests shadow memory and shadow memory has been 
allocated, J.SWAPR attempts to allocate shadow memory according to the task’s state 
and priority. 

The difference between H class memory and the shadow memory classes is that 
normally, if H class memory is not available, E class can be allocated. With the 
shadow memory classes, E class memory is never requested for the shadow memory 
area. H class memory cannot be used with HI, H2, or H3 class memory. 
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After a task has been configured, there are three ways that a task can access shadow 
memory: 


J.SHAD This utility permanently specifies the portions of a task’s logical 
address to be located in shadow memory. For more information 
on J.SHAD, refer to MPX-32 Reference Volume II. 

$SHADOW This directive specifies the portions of a task’s logical address to 
be located in shadow memory. For more information on 
SSHADOW, refer to MPX-32 Reference Volume II. 


M.PTSK This service activates a task. When used with a type 11 RRS 
(assign to shadow memory), it specifies the portions of a task’s 
logical address to be located in shadow memory. Nonshadow 
memory is specified as E or S class in word 0, byte 3 of the 
parameter block. This service is only for privileged users. For 
more information on M.PTSK, refer to MPX-32 Reference Manual 
Volume I. 


10.19 Error Messages 

If shadow memory is not software configured and physical shadow memory is present 
and noncontiguous, the following message appears on the console: 

NOTE: NO SHADOW MEMORY SYSGENED AND NONCONTIGUOUS {CPUIIPU} SHADOW 
MEMORY DETECTED 

If shadow memory is software configured and physical shadow memory is present and 
noncontiguous, the following message appears: 

NOTE: NONCONTIGUOUS {CPUIIPU} SHADOW MEMORY DETECTED - RUNNING IN 
DEGRADED MODE 

If shadow memory is not software configured, the image is not a master image, and 
physical shadow memory is present but does not cover all the memory that is software 
configured, the following message appears: 

NOTE: NO SHADOW MEMORY SYSGENED BUT {CPU|IPU} SHADOW MEMORY DETECTED 

When shadow memory is software configured and configuration errors are detected 
because physical shadow does not match that configured, the following message 
appears: 

WARNING: {CPUIIPU} SHADOW MEMORY ERRORS - MAY BE RUNNING IN DEGRADED 

MODE 
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The following display occurs after any of the above error messages: 

{CPUflPU} SHADOW MEMORY size BOARD 

UNIT* AT { nnnnnnnn | MALFUNCTION OR NONPRESENT} 

size indicates the size of the shadow memory board: 128KW, 512KW or 4MB 

• specifies the unit number 

nnnnnnnn specifies the address of the shadow memoiy board 

10.20 Memory Disk 

The MPX-32 memory disk is a partition of main memory. The memory disk 
simulates a moving head disk, except the memory disk: 

• seeks and accesses data at a faster rate 

• has a lower capacity 

• is not bootable 

• cannot be used as a physical cache disk 

• can only be single or dual-ported 


If configured, the memory disk partition is allocated during system initialization, 
unless the system administrator requests otherwise at system generation. 

There are two system tasks for memory disk usage — J.MDSAVE and J.MDREST. 
J.MDSAVE dumps the contents of memory disk to a system file. J.MDREST restores 
any unmounted memory disks saved by J.MDSAVE. See the J.MDSAVE and 
J.MDREST sections in this chapter for more information. 

Memory disk can be marked online and offline by the OPCOM ONLINE and 
OFFLINE directives. These directives also allow the allocation and deallocation of 
the memory disk’s memory. See OPCOM ONLINE and OFFLINE in MPX-32 
Reference Manual Volume II for more information. 

The memory disk handler is named H.MDXIO. Refer to the MPX-32 Technical 
Manual Volume II for more information. 

Notes: 

Dual-ported memory disks can be located only in a multiprocessor shared memory 
area. Single-ported memory disks can be located in any memory area except the 
multiprocessor shared memory area. 

Up to 8 memory disks can be configured as long as the subaddress is not the same as 
the null device. Memory disks can be configured on channel 00, subaddress 0 and 
any following even subaddress. Memory allocated to a memory disk must be 
contiguous. 

If the reloading of all memory disks is required at restart or IPL, use the SYSGEN 
SEQUENCE directive to activate J.MDREST. The M.MOUNT directive cannot 
reload a memory disk and should not be used to mount any memory disks that will be 
reloaded. 
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High priority real-time tasks that relinquish control only while I/O is in progress take 
an unfair amount of CPU time unless their I/O priorities are modified. 


10.20.1 Memory Disk Configuration 

The configuration size of a memory disk must be greater than 12KB. The memory 
disk size is specified at SYSGEN. To configure a memory disk, the following steps 
are necessary: 

1. Add a SYSGEN CONTROLLER directive for each memory disk (channel 00). 

2. Add a SYSGEN DEVICE directive for each memory disk. 

3. Add a SYSGEN SEQUENCE directive for J.MDREST, if required. For more 
information on this option, refer to the J.MDREST system task in this chapter. 

4. Perform a SYSGEN. 

5. Restart the system. 

Refer to the appropriate directive for specific memory disk information. 

10.20.2 Memory Disk Usage 


10.20.2.1 Formatting and Mounting a Memory Disk 

After a system restart, a memory disk is formatted using the Volume Formatter 
(J.VFMT). A memory disk can then be mounted using the OPCOM MOUNT or 
TSM $MOUNT directive. 

10.20.2.2 Accessing a Memory Disk 

After a memory disk has been formatted and mounted, it can be accessed like a hard 
disk; for example, through Volume Manager and the Text Editor. 

10.20.2.3 Dismounting a Memory Disk 

If a memory disk is mounted with the OPCOM MOUNT directive, it must be 
dismounted with the OPCOM DISMOUNT directive. The same is true for the TSM 
MOUNT and DISMOUNT directives. Failure to specify the corresponding directive 
results in an error message. 

10.20.3 Memory Disk Aborts and Errors 


10.20.3.1 Abort Cases 

The following is the memory disk abort code and its description. 

MM01 Request for memory disk I/O to a location outside the memory disk 
boundaries 
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Aborts during memory disk installation occur: 

• if DMOO is not specified in the CONTROLLER directive for a memory disk — 
SYSGEN aborts, and an error message is generated in the SYSGEN listed output 
file 

• when reloading a memory disk that has been publicly mounted with M.MOUNT 

• during an attempt to mount or format a memory disk for which no partition is 
present 


Other possible aborts are the same as for other types of disk drives. 


10.20.3.2 Errors 

Errors that result from improper configuration cause a trap at assign time. The 
following memory disk errors result in messages displayed on the operator’s console: 

• insufficient contiguous memory of the correct type 

• requests for OPCOM to mark online a deallocated memory disk that cannot be 
fulfilled because there is no available contiguous memory 

• attempts to deallocate a dual-ported memory disk’s memory 


All other errors, such as end-of-medium and full disk, are a result of improper disk 
usage, and display the same error messages as other types of disk device errors. 


10.20.4 Memory Disk Save Task (J.MDSAVE) 

J.MDSAVE saves the contents of a memory disk to a system file. To activate 
J.MDSAVE, logon as the system administrator, then type: 

J.MDSAVE DMOO nn 

nn is the subchannel of the memory disk 

The contents of the specified memory disk are saved to a system file named 
@SYSTEM(SYSTEM)DM00w/i. See Figure 10-4. 
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R3090 


Figure 10-4 
Memory Disk 

10.20.5 Memory Disk Restore Task (J.MDREST) 

J.MDREST restores all unmounted memory disks that have been saved by the 
J.MDSAVE system task. Before using J.MDREST, the J.MDSAVE system task must 
have been used. See Figure 10-4. To activate J.MDREST, logon as the system 
administrator, then type: 

J.MDREST 

When the SYSGEN SEQUENCE directive is entered as follows, J.MDREST is 
activated at system initialization: 

SEQUENCE=J. MDREST 

This reloads any unmounted memory disks from the system disk files saved by 
J.MDSAVE (@SYSTEM(SYSTEM)DMOO/?n). It is important to activate J.MDREST 
with the SYSGEN SEQUENCE directive and not the SYSGEN ACTIVATE directive. 
If ACTIVATE is used, an error message is displayed. 

The M.MOUNT file should not contain entries for the memory disks to be reloaded. 

If the M.MOUNT file contains entries for memory disks to be reloaded, the mount 
messages for these entries should be aborted. If MODE=SNOP is specified in the 
SYSGEN MODE directive, no operator messages are displayed and the disks are 
mounted. 
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10.21 Label ANSI Tape Utility (J.LABEL) 

The Label ANSI Tape Utility (J .LABEL) writes the initial header labels to new ANSI 
tapes. All ANSI tapes must be labeled by the J.LABEL utility to be recognized by 
the system. This utility can be used only by the system administrator. For J.LABEL 
syntax and usage information, refer to the ANSI Labeled Tape Utilities in MPX-32 
Reference Manual Volume II. 
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11.1 Introduction 

The Device Initializer/Loader (DEVINITL) initializes devices by using an 
initialization directive file. DEVINITL also loads microcode onto devices having 
Writable Control Storage (WCS) capabilities by using a firmware file in conjunction 
with the initialization directive file. 

11.2 Initialization Directive File 

DEVINITL directives are in a file named DEV_INIT located on the system volume 
and system directory. This file contains default directives used when DEVINITL is 
activated by TSM. The DEV_INIT file contains the following three types of 
directives: 

• Option Specification (optional) — overrides default parameters for file matching 
and message displays. 

• Device Load (required) — specifies devices to be initialized and optionally specifies 
files that contain microcode to be loaded. 

• Device Initialization (optional) — specifies a directive byte and/or data required to 
initialize a device. 

Based on these directives and their defaults, if any, DEVINITL initializes devices 
and/or loads microcode, checking only record type, length, and checksum. Messages 
are displayed indicating successful device initialization and/or loading or the errors 
which occurred preventing successful initialization and/or loading. 

The format of the initialization directive file is shown in Figure 11-1. 
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Figure 11-1 

Initialization Directive File Format 


Device Initializer/Loader (DEVINITL) 
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11.3 Firmware File 

Microcode is loaded by a single execute channel program call from a single buffer that 
is extracted from a firmware file on disk. When using TSM, the loading process is 
overridden by specifying option 9 before activating DEVINITL, in which case only 
the initialization process is performed. 

As the microcode can be of any type, DEVINITL can load any WCS within the scope 
of its recognized record types. 

The firmware file contains two types of records: data and control. All data record 
types are valid. Five control record types are valid: 

• logical end-of-record 

• header record 

• set address-field length 

• set checksum-field length 

• terminate load record 


These fields are further described in Table 11-1. 
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Table 11-1 

Valid Control Record Types 


Control Byte Value 
Decimal Hex 

Loader Control Record Description 

0 

0 

Logical end-of-record - Remaining 
data in the current operating system 
record is ignored. 

241 

FI 

Header record - The second byte of 
the record contains the number of 
data bytes in the record. The record 
can contain any file identification 
desired. 

242 

F2 

Set address-field length - The next 
byte in the record defines the length 
of the address field in bytes for all 
subsequent loader data records. 

243 

F3 

Set checksum-field length - The next 
byte in the record defines the length 
of the checksum field in bytes for all 
subsequent loader data records. 

244-254 

F4-FE 

Reserved 

255 

FF 

Terminate load record - This record 
indicates the end of the load. The 
address portion of this record 
specifies the initial transfer address 
for the control microcode previously 
read. 
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11.3.1 Loader Data Record Format 

Loader data records define the data to be loaded into the device control memory 
(WCS). Each data record contains a byte count field, a microcode address field, a 
microcode data field, and a checksum field in the following format: 


Record 0 n 


Byte count 

Firmware address. 

Microcode data. 

Checksum field. 

See Note 1. 

See Note 2. 

See Note 3. 

See Note 4. 


Notes: 

1 . The byte count field defines the number of data bytes in the microcode data 
portion of the record. It also identifies the record as a loader data record as 
opposed to a loader control record. Valid byte counts are X’01’ through X’FO’. 

2. The firmware address field is a series of bytes defining the portion of the control 
memory where the associated data will be loaded. The default length of this field 
is 2 bytes; however, it can be changed with a Set Address-Field Length control 
record. The length specified remains in effect until another Set Address-Field 
Length control record is specified or end-of-file is encountered. 

3. The microcode data field is a series of bytes containing the data to be loaded at 
the address specified, and in the format expected by the device. This format is 
the responsibility of the user; DEVINITL only checks record length and 
checksum. 

4. The checksum field is a series of bytes containing the checksum value for the 
microcode data field. The default length of this field is 1 byte; however, it can 
be changed with a Set Checksum-Field Length control record. The length 
specified remains in effect until another Set Checksum-Field Length control 
record is specified or end-of-file is encountered. 
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11.4 Using DEVINITL 

DEVINITL can be activated at IPL, in batch mode or in interactive mode, by TSM. 

To activate DEVINITL at IPL time, use the SYSGEN ACTIVATE directive. Refer to 
the SYSGEN chapter in this manual. DEVINITL is activated immediately upon 
successful loading of the system image. When DEVINITL is activated at IPL time or 
in batch mode, milestone and error messages are displayed on the system console. 

When DEVINITL is activated interactively, milestone and error messages are 
displayed on the terminal, and directives are passed to DEVINITL from the terminal. 
The first input required is a DEVICE directive. The initialization directive file is 
searched for the corresponding device entry. 

If the device entry is found, any other valid directive can be entered. Any directive 
entered overrides the corresponding directive in that device’s section. Any directive 
not entered defaults to that directive entry in the device’s section. Terminal input only 
overrides initialization directive file directives; it does not permanently change them. 

A carriage return ends directive entry at the terminal. 

If the device entry is not found, DEVINITL displays an appropriate message. 
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11.5 DEVINITL Directives 

DEVINITL directives are summarized below, by command type. Each directive is 
described in detail in the remainder of this section, arranged alphabetically by 
directive name. Valid abbreviations are shown in bold type. In the initialization 
directive file, comments can be included in a directive line by specifying an 
exclamation point (!) anywhere on the line except within quoted ASCII strings. The 
remainder of the line is ignored. 

All directives in an initialization directive file must be on separate lines. 

When directives are entered through TSM, DEV_CNTRL is the only directive that 
must be on a separate line. All other directives can be continued across as many lines 
as necessary by placing a hyphen (-) as the last significant character on the line. 

Option Specification Directive 

OPTION specifies whether parameter defaults for file matching and message 

displays are to be overridden for subsequent device entries in the 
initialization directive file. This directive is valid in the initialization 
directive file only. 


Device Load Directives 


DEVICE 


IDENT 

REREAD 


RETRY 

WCS_F1LE 


specifies the device mnemonic, channel, and subchannel addresses 
for a device to be initialized and/or loaded. This directive is required 
for each device to be initialized and/or loaded. It must be the first 
command specified in the Device Load Directive section. 

specifies a header record ASCII string that must be matched if 
OPTION WCSMATCH=Y is specified. This directive is not 
required if OPTION WCSMATCH=N. 

specifies the number of read attempts to be performed on a firmware 
file if a read error occurs. The number specified is also used as the 
number of read attempts to be performed when the number of load 
attempts specified by a RETRY directive expires. 

specifies the number of load attempts to be performed on a device if 
a load error occurs. 

specifies the pathname of a file containing microcode to be loaded 
onto a device. This directive is required if OPTION 
WCSMATCH=Y is specified or if microcode is to be loaded onto a 
device. 


Device Initialization Directive 

DEV_CNTRL specifies device initialization is required. 
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1 1 .5.1 DEV_CNTRL Directive 

The DEV_CNTRL directive initializes a device. If this directive is not specified for a 
device, that device is not initialized. Special directives or data needed to perform the 
initialization can be specified. 

When this directive is encountered, DEVINITL creates an input/output command 
doubleword (IOCD) using any data specified. The IOCD is then passed to the execute 
channel program for execution. 

More than one DEV_CNTRL directive can be specified. However, only one 
DEV_CNTRL directive can be specified per input line. 

Syntax 

DEV CNTRL [CMD=cc] [data I ’string’] 

[CMD=cc] specifies the value of a valid hexadecimal IOCD directive byte. If not 
specified, default is X’FF’ to initialize controller. 

data is any valid hexadecimal data. Each byte of data must be separated by a 

blank or a comma. Data cannot be carried over one input line. 

’ string ’ is any ASCII data string enclosed in single quotes. Data cannot be 

carried over one input line. Its format is not checked. 

If no parameters are specified, the device is initialized using system defaults. 

Examples 

The following example passes the ASCII string STARTUP to a device with a byte 
count of 7 with the initialization directive byte X’F3’. 

DEV_CNTRL CMD=F3 'STARTUP' 

The following example passes data F081C2F7B177FF to a device with a byte 
count of 7 with the default initialization command byte X’FF’. 

DEV FO 81 C2 F7 B1 77 FF 
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11.5.2 DEVICE Directive 

The DEVICE directive specifies a device that will be initialized and/or loaded. This is 
required in each device’s device load directive section in the initialization directive file 
(see Figure 11-1), and must be the first directive in the section. 

The device to be initialized and/or loaded must have been specified as a device at 
SYSGEN. If this directive is not specified or if an invalid device is specified, a fatal 
error occurs, ending the loading process using the initialization directive file. 

Syntax 

DEVICE -mmccss 

mm is a 2-character device mnemonic 

cc is a 2-character device channel address 

ss is a 2-character device subchannel address 

Examples 

The following example initializes and/or loads firmware onto the card reader (CR) on 
c hannel 2 0 , subchannel 0 8 . 

DEVI=CR2008 


11.5.3 IDENT Directive 

The IDENT directive causes the header record of a firmware file to be searched for a 
specified ASCII string. 

This directive is required if OPTION WCSMATCH=Y is specified. If a match is 
found, firmware loading proceeds. If a match is not found, an error is reported and 
DEVINITL proceeds to the next device entry in the initialization directive file. 

Syntax 

\DENT= string’ 

’string’ is any ASCII data string enclosed in single quotes. Data cannot be 
carried over one input line. Format is not checked. 


Examples 

The following example causes the header record of a firmware file to be searched for 
the String FIRMWARE HEADER TY2.1. 

ID=' FIRMWARE HEADER TY2.1' 
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11.5.4 OPTION Directive 

The OPTION directive overrides DEVINITL defaults for header record searches and 
output message displays for subsequent device entries in the initialization directive 
file. This directive remains in effect until another OPTION directive is specified or 
the initialization directive file terminates. 

This directive is optional and is valid in the initialization directive file only. Although 
both the WCSMATCH and MILESTONE parameters are optional, one of them must 
be specified if the OPTION directive is used. Both of them can be specified in one 
directive. Values yes (Y) and true (T) are synonymous. Values no (N) and false (F) 
are synonymous. 

Syntax 

OPTION [WCSMATCH={ Y I N}] [MILESTONES Y I N}] 

[WCSMATCH={YIN}] 

specifies if subsequent header records in the firmware file must match an 
ASCII string which is specified by an EDENT directive. If Y and a match 
is not found, firmware loading is aborted. If N is specified, a match is not 
required and firmware loading proceeds. If not specified, the default is N. 

[MILESTONES YIN}] 

specifies whether milestone messages indicating successful operations are 
to be displayed or inhibited during subsequent device initialization and 
firmware loading. If Y is specified, messages are displayed. If N is 
specified, milestone messages are not displayed (but error messages are). 
If nothing is specified, default is Y. 


Notes: 

If this directive is specified, at least one of the parameters must be used. 

Examples 

The following example requires subsequent device entries in the initialization directive 
file to match the ASCII string specified with an IDENT directive. Milestone messages 
are not displayed. 

OPTI WCSMATCH=Y MILESTONE=N 
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11.5.5 REREAD Directive 

The REREAD directive specifies the number of read attempts performed on a 
firmware file when a read error occurs. When the specified number is exhausted, an 
error is reported. 

The number specified by this directive is also used independently by the RETRY 
directive. 

Syntax 

REREAD -num 

num is any decimal number 0 through 99999999. If not specified, the default 

is 1. 


Examples 

The following example specifies 3 read attempts are made on the firmware file if a 
read error occurs. 

REREAD=3 


11.5.6 RETRY Directive 

The RETRY directive specifies the number of load attempts made on a device when a 
load error occurs. When the specified number is exhausted, DEVINITL automatically 
rewinds the firmware file and then attempts a read. The number of read attempts is 
the number specified in a REREAD directive. 

When the RETRY and REREAD numbers are exhausted, an error is reported and 
DEVINITL proceeds to the next device entry in the initialization directive file. 

Syntax 

RETRY -num 

num is a decimal number 0 through 99999999. If not specified, the default is 

3. 


Examples 

The following example specifies that 5 load attempts are to be made on a device if a 
load error occurs. If loading is not successful after the fifth attempt, the firmware file 
automatically rewinds and read attempts are made, decrementing the REREAD 
directive specification. 

RETRY=5 
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11.5.7 WCS_FILE Directive 

The WCS_FELE directive specifies the pathname of a file containing microcode to be 
loaded onto a device. 

This directive is required if OPTION WCSMATCH=Y is specified or if microcode is 
to be loaded onto a device. If an invalid pathname is specified or DEVINITL is 
denied access to the specified file, an abort occurs and an error is reported. 

Syntax 

WCS_ FILEspathname 

pathname is the pathname of a file containing microcode 

Examples 

The following example loads the microcode file WCS . 1 located on the volume 
SYSTEM and directory firmware onto the specified device. 

WCS SSYSTEM (FIRMWARE) WCS . 1 


1 1 .6 Example Initialization Directive File 


In the following initialization directive file, all directives are on separate lines. 


OPTION WCSMATCH=Y MILESTONES 

DEVICE=CR2008 

ID=' CARD READER FIRMWARE' 

REREADS 

RETRY=1 

WCS_FILE=@SYSTEM (FIRMWARE) WCSCR 

OPTION WCSMATCH=N 

DEVICE=TY7EB3 

DEV_CNTRL CMD=F3 IB 1C 

DEVICE=TY7EB4 

DEV_CNTRL CMD=F3 IE 

DEVICE=TY7EB5 

DEVJSNTRL 

OPTION WCSMATCH=N MILESTONE=Y 

DEVICE=DC7EC0 

REREAD=3 

RETRY=5 

WCS FILESSYSTEM (FIRMWARE) WCSDISC 


! DEVICE 1 


! DEVICE 2 


! DEVICE 3 
! DEVICE 4 
! DEVICE 5 


In the following example, directives are entered from TSM. Directives are continued 
across lines except for DEV_CNTRL, which is on a separate line. In this case, the 
hyphen signifies continuation of input for the same device. 

TSM> DEVINITL DEVICE=CR2008 ID=' CARD READER FIRMWARE' - 
DEV> REREADS RETRY=1- 
DEV> DEV CNTRL 
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11.7 Milestone Messages 

The following message is displayed when a device is successfully initialized. 
DEVICE XXXXXX INITIALIZED 

The following message is displayed when firmware is successfully loaded onto a 
device. 

DEVICE XXXXXX HAS BEEN LOADED WITH THE FIRMWARE 
CONTAINED IN WCS FILE XXXXXXXX 

1 1 .8 Error Conditions and Messages 


11.8.1 Initialization Directive File Errors 

The following message is displayed when DEVINITL is activated by TSM and a 
corresponding device entry is not found in the initialization command file. 

NO DEFAULT DATA IS AVAILABLE FOR DEVICE XXXXXX 

The following message is displayed when action is not taken on a device entry within 
the initialization directive file. 

** WARNING ** NO ACTION HAS BEEN CARRIED OUT FOR DEVICE XXXXXX 

Action is not taken because one of the following occurred: 

• option 9 is set 

• a DEV_CNTRL command is not specified for the device entry 

• a WCS_FILE directive is not specified for the device entry 

The following message is displayed when the initialization directive file does not 
contain sufficient directives for processing a device before end-of-file detection. 

** ERROR ** A PREMATURE END-OF-FILE HAS BEEN DETECTED ON THE 
CONTROL FILE 


The following message is displayed when a nondecimal number is specified with a 
REREAD directive. 

** ERROR ** INVALID REREAD PARAMETER SPECIFIED XXXXXXXX 


The following message is displayed when a nondecimal number is specified with a 
RETRY directive. 

** ERROR ** INVALID RETRY PARAMETER SPECIFIED XtVXYXXX 
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11.8.2 Device Loading Errors 

When a device cannot be successfully loaded, the following message is displayed 
along with the appropriate reason. 

** ERROR ** UNABLE TO LOAD DEVICE XXXXXX FOR THE FOLLOWING REASON: 

DEVICE CHANNEL MUST BE HEXADECIMAL. 

DEVICE TYPE NOT CONFIGURED ON HOST SYSTEM. FOUND XC 

UNABLE TO ALLOCATE DEVICE XXXXXX M.ASSN ERROR CODE:xc 

UNABLE TO ALLOCATE FILE XUXXUX M.ASSN ERROR CODE: xc 

WCS FILE XXXXXXXX IS INVALID - CONTAINS NO TERMINATION RECORD. 

WCS FILE xcxtxtxc IS INVALID - CONTAINS AN ERRONEOUS BYTE COUNT. 

OFFENDING RECORD BYTE COUNT: xt 

FIRMWARE ADDRESS: XXXX 

WCS FILE XXXXXXXX IS TOO LARGE FOR DEVINITL. 

OFFENDING RECORD BYTE COUNT: XX 
FIRMWARE ADDRESS: xcxt 

Including microcode and data, maximum file size is 64K. 

WCS FILE XXXXXXXX CONTAINS INVALID COMMAND: HEX xt 
HARDWARE ERROR STATUS RECEIVED. STATUS AFTER LAST RETRY: 

HEX XXXX 

UNABLE TO OPEN DEVICE XtXXtt DEVICE MAY NOT BE PRESENT 


11.8.3 Directive Parsing Errors 

The following message is displayed when an invalid pathname is specified with the 
WCS_FILE directive. The string xtxuxtv contains up to 80 characters. 

** ERROR ** PATHNAME SYNTAX ERROR: XXXXXXXX 


The following message is displayed when OPTION WCSMATCH=Y and an EDENT 
directive have been specified, but a match is not found in the header record of the file 
being searched. 

** WARNING ** INCORRECT FIRMWARE REVISION FOR DEVICE XYXXXt 
REQUESTED XXXXXXXXXXXXXXXX 
ACTUAL XXXXXXXXXXXXXXXX 

The following message is displayed when the execute channel program call fails after 
the specified number of RETRY and REREAD attempts. The number output as the 
reason is the contents of the third word of the FCB. 

DEVICE XXXXXX INITIALIZATION FAILED. 

REASON xxxtxvxt 

The following message is displayed when a non-hexadecimal digit is found during 
IOCD creation at initialization time. The initialization line is ignored. 

** ERROR ** INVALID HEXADECIMAL CHARACTER: X 
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The following message is displayed when the two least significant bits of the IOCD 
operation code directive specified with DEV_CNTRL CMD=xx are not set. 

** ERROR ** XX IS INVALID IOCL COMMAND 

When a parse error occurs for a reason other than those described above, the following 
message is displayed along with the appropriate reason. Below this, the erroneous line 
is displayed with an exclamation point (!) below the item that caused the parse error. 

** PARSE ERROR ** 

AN EQUAL SIGN IS MISSING FOLLOWING A KEYWORD 
PREMATURE END OF INPUT STRING 
A directive is truncated. 

DEVICE IDENTIFICATION IS MISSING 
UNRECOGNIZABLE DIRECTIVE 

A STRING IS MISSING FOLLOWING AN EQUAL SIGN 

A QUOTED STRING IS IMPROPERLY TERMINATED 

An end quote is missing or attempt was made to carry a string past one 
input line. 

AN ASSUMED OPTION LINE CONTAINS NO OPTION DIRECTIVES 

Parameter WCSMATCH and/or MILESTONE must be specified with an 
OPTION command. 

A PREMATURE END-OF-STRING OCCURRED IN OPTION 
SPECIFICATION 

An OPTION directive cannot be carried past one input line. 

THE SPECIFIED OPTION IS UNDEFINED 

RETRY/REREAD IS NOT A POSITIVE DECIMAL 

INVALID OPTION SENSE SPECIFIED OPTIONS=Y, N, T, F, OR 
BLANK 
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12 Alterable Control Store (ACS) 


12.1 Introduction 

The Alterable Control Store (ACS) Load and Display Utility performs two functions 
— LOADACS and DUMP ACS. LOADACS writes firmware to the ACS or Writable 
Control Store (WCS). DUMP ACS displays or compares firmware in Programmable 
Read Only Memory (PROM), ACS, and WCS. Through the SETCPU instruction, 
MPX-32 specifies whether the processor uses the PROM or ACS firmware. 

With the exception of the CHECKSUM directive, the ACS Utility runs only on a 
CONCEPT 32/67 computer. The CHECKSUM directive can be used on any 
CONCEPT/32. 

The numbers accepted and generated by LOADACS and DUMP ACS are hexadecimal, 
except for decimal RMw error codes. 

12.2 LOADACS Directive File (M. ACS) 

The LOADACS directives are in a file named M.ACS. M.ACS must be located on 
the system volume and the system directory. Use the Text Editor to create the file. 

M.ACS consists of one or more groups of directives, each group for a particular 
processor. There can be more than one group of directives for any processor. The 
last directive in each group must be followed by a semicolon. Following is the format 
of MACS. 


Group 1 

COPY, LOAD, or PATCH Directive 
VERIFY Directive (optional) 
ENABLE Directive (optional) 


Group n 

COPY, LOAD, or PATCH Directive 
VERIFY Directive (optional) 
ENABLE Directive (optional) 
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12.3 Firmware File 

The firmware file supplied must be restored as a system file using the Volume 
Manager. 

The firmware file contains logical blocks of 256 bytes. The last byte of each logical 
block is the one’s complement of the sum of all other bytes in the logical block. 
LOADACS uses this figure as a checksum during a LOAD. 

If assigned, the firmware file must be assigned as unblocked. 

1 2.3.1 CONCEPT 32/67 Usage 

The CONCEPT 32/67 has two phases of processors, phase 1 and phase 2. The user 
must know which phase their system has so the M.ACS file can be properly 
constructed. 

A properly constructed M.ACS directive loads or patches the proper firmware without 
user intervention regardless of the processor’s phase. This maintains system 
portability from one phase processor to another. 

The processor’s phase is determined by the processor (CPU or IPU) PROM revision 
level. See the REVISION directive. If the last 8 digits of the revision number are 
2282000«, where n is any number, the processor is a phase 1. 

Any other numbers indicate a phase 2 processor. 

12.3.2 Firmware File Record 

The maximum record length is one logical block; therefore, the maximum record size 
is 251 bytes. The maximum number of 64-bit microwords per record is 31. The 
format of a record is: 

0 7 8 23 24 n 


Microword Count (Byte 0). See 

Start Address 

Data (Bytes 

Note 1. 

(Bytes 1 & 2). 
See Note 2. 

3-250). See Note 3. 


Notes: 

1. Byte 0 of a record contains the microword count for the record. A count of 00 
means the record is the last in a logical block. 

If the last record of a logical block ends in the last 3 bytes of the block, a new 
record is not started with a 00 microword count. 

An FF microword count indicates an end-of-file. 
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2. Bytes 1 and 2 of a record contain the starting address of the record’s data. Valid 
address ranges are: 

0000 to OFFF for ACS or PROM 
1000 to 1FFF for 4K x 64 WCS 
1000 to 2FFF for 8K x 64 WCS 

3. Bytes 3-250 of a record contain the data to be loaded. 

Microword FFD always contains the ACS or PROM firmware revision. The revision’s 
format is: 

C67 rnzzppppppzzzn 

C = CONCEPT/32 
67 = 2-digit type of CONCEPT/32 
r = firmware revision letter 
n = firmware revision number 
z = 0 

p = 6-digit firmware part number 

C67 rn, with the variables filled, is the firmware source filename. 

The following is an example of an ACS/PROM firmware revision. 

C67 A300322820003 

The example’s firmware source filename is C67A3. The firmware part number is 
322820. 

Microword FFE always contains the ACS or PROM data checksum. The checksum is 
the one’s complement of the sum of the microwords. It is calculated by LOADACS 
during writes to ACS. 
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12.4 LOADACS 

LOADACS is a subroutine in J.INIT that is executed during IPL and RESTART 
sequences. LOADACS receives commands from the M.ACS command file. If any of 
the following conditions are true, the firmware is not loaded and the load, patch, or 
copy message is not displayed: 

• control switch 9 is set 

• the machine is not a CONCEPT 32/67 

• the sequence is not an IPL or RESTART 

• MACS does not exist 

• MACS is empty 

LOADACS accepts different firmware and actions for the CPU and IPU. If the IPU is 
offline, a load request causes an error message to be displayed. 

LOADACS rims in the processor it is loading. Before loading ACS or WCS, 
LOADACS executes the SETCPU instruction to enable transfer in the PROM mode. 
LOADACS blocks external interrupts in the CPU before loading, and unblocks them 
afterward. In the IPU, LOADACS inhibits context switching. 

To load new firmware in ACS or WCS, use the LOAD directive. To load PROM 
firmware with modifications, use the COPY directive followed by a LOAD or PATCH 
directive. To modify ACS or WCS, use a LOAD or PATCH directive. PROM 
cannot be loaded or modified. 

All LOADACS output is displayed on the operator console and the LOD device. A 
message is displayed after a successful load. 
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12.5 DUMPACS 

DUMPACS is a subroutine in J.INIT. When UNIT is called from TSM and option 1 
is set, DUMPACS is the only subroutine called. DUMPACS then displays a DMP 
prompt for directives. 

TSM> OPTION 1 
TSM> J.INIT 
DMP> 


Depending on the directive, the results are written to logical file code UT or the LOD 
device. These logical file codes cannot be reassigned. 

DUMPACS dumps the contents of ACS, WCS, and PROM, compare the contents of 
these storage areas with a firmware file, and calculate checksums to be used by the 
LOADACS PATCH directive. DUMPACS also displays the revision microword and 
the mode of a processor. 


12.6 ACS Directives 

ACS directives are summarized below, arranged by function type. Each directive is 
described in detail in the remainder of this section, arranged alphabetically by 
directive name. 

LOADACS Directives 


Directive 

COPY 

ENABLE 

LOAD 

PATCH 

VERIFY 


Description 

copies contents of PROM to ACS 

sets processor in ACS or PROM mode. This directive is 
not valid for WCS. 

loads firmware file into ACS or WCS 
loads data from M.ACS to ACS or WCS 

compares ACS or WCS with the data that was 
written to ACS or WCS 


DUMPACS Directives 


Directive 


Description 


CHECKSUM 

COMPARE 

DUMP 

EXIT 

MODE 

REVISION 


provides the checksum used by the PATCH directive 
compares ACS, WCS, or PROM with a firmware file 
dumps specified memory contents to the LOD device 
exits DUMPACS and returns to TSM 
displays the mode of a processor 
displays revision microword on LFC UT 
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12.6.1 CHECKSUM Directive 

The CHECKSUM directive is used by DUMP ACS to add values and compute the 
one’s complement of the sum. The sum is then displayed on LFC UT. 

When using LOAD ACS, the sum is the value entered in the optional SUM parameter 
for the PATCH directive. 

The CHECKSUM directive can be continued across more than one input line by 
placing a hyphen (-) as the last significant character on the line to be continued. The 
hyphen must not be embedded in a value. 

Syntax 

CHECKSUM value [, value ...] 

value is a value to be patched by LOAD ACS 

Examples 

The following example adds three values and computes the one’s complement of the 
sum. The resulting value can be in the PATCH directive for the SUM parameter. 

CHECKSUM 2433F55EC0024, 99FA5500, BB4302 


12.6.2 COMPARE Directive 

The COMPARE directive is used by DUMPACS to compare the contents of the 
specified ACS, WCS, or PROM with a firmware file. When the firmware file and 


memory do not match, the memory location’s address and contents plus the file’s 
contents are written to the LOD device. The firmware file must be formatted as 
described in section 12.3.2, Firmware File Record, of this chapter. 

Syntax 


COMPARE {CPUIIPU} { ACS 1 PROM 1 WCS) pathname 

CPU 

specifies the CPU is the processor that is used 

IPU 

specifies the IPU is the processor that is used 

ACS 

specifies the ACS is read 

PROM 

specifies the PROM is read 

WCS 

specifies the WCS is read 

pathname 

is the pathname of the firmware file. If the file does not exist, an error 
message is displayed. 
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Examples 

The following example compares the contents of the CPU’s ACS to the system file 
named FIRM. 

COMPARE CPU ACS QSYSTEM (SYSTEM) FIRM 

The following example compares the contents of the IPU’s WCS to the user file 
named FIRM. 

COMPARE IPU WCS FIRM 

12.6.3 COPY Directive 

The COPY directive is used by LOAD ACS to copy the contents of PROM to the 
CPU or IPU ACS. 

Syntax 

COPY {CPU I IPU} 

CPU specifies the CPU ACS is written 
IPU specifies the IPU ACS is written 
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12.6.4 DUMP Directive 

The DUMP directive is used by DUMP ACS to write the specified memory contents to 
the LOD device. If starting and ending addresses are not specified, the entire contents 
of the specified memory are written. 

If an invalid address is specified, an error message is displayed on the terminal. 

Syntax 

DUMP { CPU I IPU } { ACS I PROM i WCS } [startaddr] [, endaddr] 


CPU 

specifies the CPU is the processor that is used 

IPU 

specifies the IPU is the processor that is used 

ACS 

specifies the ACS is read 

PROM 

specifies the PROM is read 

WCS 

specifies the WCS is read 

startaddr 

is the starting address of the dump 

endaddr 

is the ending address of the dump 


Examples 

The following example writes the entire contents of the CPU’s ACS to the LOD 
device. 

DUMP CPU ACS 


12.6.5 ENABLE Directive 

The ENABLE directive is used by LOADACS to set the processor which was just 
used for a COPY, LOAD, or PATCH, in the ACS or PROM mode. This directive is 
not valid for the WCS mode. 

If the ACS mode is requested and a previous LOAD, COPY, PATCH, or VERIFY 
directive failed in ACS, the mode is not changed and an error message is written. 

If the ENABLE operation is successful, the mode of the processor is reported to the 
console and the LOD device. When an ENABLE of IPU ACS causes the IPU to be 
marked offline due to incompatible firmware, the message EPU MARKED OFFLINE 
is displayed instead of the mode. 

Syntax 

ENABLE {ACS I PROM} 

ACS specifies the processor uses the ACS firmware 

PROM specifies the processor uses the PROM firmware 
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12.6.6 EXIT Directive 

The EXIT directive exits DUMP ACS and returns control to TSM. 


Syntax 

EXIT 




12.6.7 LOAD Directive 

The LOAD directive is used by LOADACS to load a firmware file into ACS or WCS. 
If an ACS load is not successful, the processor used remains in the PROM mode. 

The LOAD directive can be continued across more than one line by placing a hyphen 
(-) as the last significant character on the line to be continued. The hyphen must not 
be embedded in a value and must directly precede the ACSMATCH or WCSMATCH 
keyword. 

Syntax 

LOAD {CPUIIPU} {ACS I WCS} F\LE=plfile [,p2file] 

[{ACSMATCH I WCSMATCH }=plrev \p2rev ] ] 

CPU specifies the CPU is the processor that is used 
IPU specifies the IPU is the processor that is used 

ACS specifies the firmware is loaded into ACS 

WCS specifies the firmware is loaded into WCS 

pi file specifies the 1- to 16-character name of the file containing the firmware 

loaded for a phase 1 processor. If p2file is not specified, pi file is loaded 
regardless of the processor type. 

[,p2file\ specifies the 1- to 16-character name of the file containing the firmware 
that is loaded for a phase 2 processor. When specified, either pi file or 
p2file is loaded depending on the processor’s phase: 


plfile 

p2file 

Processor 

Phase 

File 

Loaded 

present 

not present 

1 

plfile 

present 

not present 

2 

plfile 

present 

present 

1 

plfile 

present 

present 

2 

P 2file 


ACSMATCH 

compares the current ACS revision number to the number specified by 
revnum. Valid only for warm starts. 

WCSMATCH 

compares the current WCS revision number to the number specified by 
revnum. Valid only for warm starts. 
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pi rev is a 16-digit revision number. If pi rev and the current revision number 
do not match, a load does not take place and an error message is written 
to the LOD device. If a match occurs, the firmware is loaded regardless 
of the processor type. 

[p2rev] is a 16-digit revision number. When specified, the firmware is loaded 
conditionally depending on the processor’s phase: 


Processor 

plrev p2rev Phase Action 


present present 1 
present present 2 
present not present 1 
present not present 2 


revision number compared 
to plrev. If matched, 
firmware is loaded. If not 
matched, no load occurs. 

revision number compared 
to p2rev. If matched, 
firmware is loaded. If not 
matched, no load occurs. 

revision number compared 
to plrev. If matched, 
firmware is loaded. If not 
matched, no load occurs. 

revision number compared 
to plrev. If matched, 
firmware is loaded. If not 
matched, no load occurs. 


Examples 

The following example compares the ACSMATCH revision number to the current 
ACS revision number. If the numbers match, the contents of file FIRM are loaded 
into the CPU’s ACS. 

LOAD CPU ACS FILE=FIRM ACSMATCH=C67A303228200003 

The following example loads the contents of file FIRM into the IPU’s WCS. 
LOAD IPU WCS FILE=FIRM 


12.6.8 MODE Directive 

The MODE directive is used by DUMP ACS to display the mode of a processor on the 
device assigned to LFC UT. 

Syntax 

MODE {CPU I IPU} 

CPU specifies the mode of the CPU 

IPU specifies the mode of the IPU 
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12.6.9 PATCH Directive 

The PATCH directive is used by LOADACS to modify the contents of ACS or WCS. 

The PATCH directive can be continued across more than one input line by placing a 
hyphen (-) as the last significant character on the line to be continued. The hyphen 
must not be embedded in a value and must fall after the first value and before the 
SUM parameter. 

Syntax 

PATCH { CPU I IPU } [PI I P2] { ACS I WCS } LOC =addr VALUE =val [,val...] [SUM=«um] 

CPU specifies the CPU is the processor that is used 

IPU specifies the IPU is the processor that is used 

PI specifies a phase 1 32/67 processor 

P2 specifies a phase 2 32/67 processor 

ACS specifies the ACS is patched 

WCS specifies the WCS is patched 

LOC=addr 

addr is the address in ACS or WCS loaded with the contents of M.ACS 

VALUE=va/ [,va/...] 

val is a value to be patched 

[SUM=swm] 

sum is a number to be compared with the one’s complement of the sum of 
the values. If sum does not equal the one’s complement of the sum of the 
values, an error message is written. 

If the specified phase and the actual phase mismatch, a warning message is sent to the 
LOD and the rest of the command group is skipped. Failure to conditionally patch 
does not disable ACS. 
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Examples 

The following example compares the one’s complement of the sum of the values to 
the number in the SUM parameter. If the numbers match, the values are patched into 
the CPU’s ACS. 

PATCH CPU ACS LOC=E30 VALUE=4F55D234, 3534AD24- 
,4536 SUM=FFFFFFFFB0753B3C 

The following example patches location 1E30 in the IPU’s WCS with the value 
35F82. 

PATCH IPU WCS LOC=1E30 VALUE=35F82 

In the following example, the first two directive groups are conditional patches 
depending on the 32/67 processor’s phase. The third directive group is 
unconditionally patched, and the last directive group passes control to ACS. 

PATCH CPU PI ACS LOC=E30 VALUE=FEE, F1EF0EF00 , FACE, FADE 
VERIFY; 

PATCH CPU P2 ACS LOC=E3E VALUE=0,0, COFFEE, DIODE 
VERIFY; 

PATCH CPU ACS LOC=E2 9 VALUE=DEADDEAD , DEADDEAD 
VERIFY; 

ENABLE ACS; 


12.6.10 REVISION Directive 

The REVISION directive is used by DUMPACS to display the revision microword on 
the device assigned to LFC UT. 


Syntax 

REVISION {CPU I IPU} {ACS I PROM I WCS} 

CPU specifies the CPU is the processor that is used 
IPU specifies the IPU is the processor that is used 

ACS specifies the ACS is read 
PROM specifies the PROM is read 
WCS specifies the WCS is read 
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12.6.11 VERIFY Directive 

The VERIFY directive is used by LOADACS to compare the contents of ACS or 
WCS with an internal buffer. The buffer contains the data that was written to ACS or 
WCS as the result of the previous directive. 

If the verification fails, an error message is written. 

Syntax 

VERIFY 

12.7 Sample M.ACS File 

The following is a sample M.ACS file. 

COPY CPU; (Group 1) 

PATCH CPU ACS LOC=E30 VALUE=4F55D234, 35, 34AD24- (Group 2) 

,4536 SUM=FFFFFFFFB0753B3C 
VERIFY 
ENABLE ACS; 

LOAD IPU ACS FILE=IPUACS1 ACSMATCH=C67A300322820003 (Group 3) 
ENABLE ACS; 

When the sample file is executed, the phase 1 firmware in the CPU PROM is copied 
to the CPU ACS with the COPY directive. The semicolon at the end of the directive 
signals the end of a group in the M.ACS file. 

The PATCH directive changes the contents of CPU ACS locations E30 to E33 to 
the values 4F55D234, 35, 34AD24, and 4536. The one’s complement of the 
sum of these numbers is compared to FFFFFFFFB0753B3C. 

The VERIFY directive compares the CPU ACS with the contents in the internal 
buffer. The buffer contains the M.ACS and ACS contents used in the PATCH 
directive. 

The ENABLE directive sets the CPU to the ACS mode. The semicolon at the end 
of the command signals the end of the second group of directives. 

The LOAD directive reads the IPU ACS revision number. If the actual number 
does not match the revision number specified, LOADACS goes to the next group of 
directives. If the numbers match, the phase 1 firmware in system file IPUACS1 is 
loaded into the IPU ACS. 

The last ENABLE directive sets the IPU to the ACS mode if the LOAD was 
successful. The semicolon at the end of the directive signals the end of the third 
group of directives. 
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12.8 Error Conditions and Messages 




12.8.1 LOADACS Error Conditions and Messages 

The LOADACS error messages described in this section are written to the SLO device 
and the operator console. 

The following message is displayed when the IPU is not online or SYSGENed in and 
cannot be loaded. The CPU can be loaded if necessary. 

J.INIT: CANNOT { COPY | LOAD | PATCH } IPU - IPU NOT ONLINE 

The following message is displayed when there is an unrecognizable directive in 
M.ACS. The directive is displayed and LOADACS goes to the next line of M.ACS. 

J.INIT: UNRECOGNIZED COMMAND IN M.ACS, IGNORED: 

directive 

The following message is displayed when firmware cannot be loaded because of an 
invalid address in a firmware file. The address and the file name containing the 
address are written. LOADACS goes to the next group of directives. 

J.INIT: CANNOT { LOAD | PATCH} {ACS|WCS} FOR {CPU|IPU} - INVALID ADDRESS 
address IN filename 

The following message is displayed when the machine type in the firmware’s revision 
number is not C67. The machine type of the new firmware is displayed. LOADACS 
goes to the next group of directives. 

J.INIT: CANNOT { LOAD | PATCH} ACS FOR {CPU|IPU} - NEW FIRMWARE HAS M/C TYPE type 

One of the following messages is displayed when the ACSMATCH or WCSMATCH 
directive is in effect and the revision number of the current firmware and the number 
specified by ACSMATCH or WCSMATCH do not match. The current firmware’s 
revision number is shown as PRESENT and the ACSMATCH or WCSMATCH 
revision number is shown as EXPECTED. LOADACS goes to the next group of 
directives. 

J.INIT: CANNOT LOAD {ACS|WCS} FOR {CPU|IPU} - PRESENT REV NUMBER NOT AS 
EXPECTED FROM {ACSMATCH | WCSMATCH } COMMAND 
PRESENT = revnumber 
EXPECTED = revnumber 

The following message is displayed when a checksum error occurs during a LOAD, 

PATCH, or COPY. LOADACS goes to the next group of directives. 

J.INIT: CANNOT { LOAD | PATCH | COPY } {ACS|WCS} FOR {CPU|IPU} - CHECK SUM ERROR IN {filename | PROM} 
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The following message is displayed when a verification fails. The address of the 
failure is displayed, plus the contents of the differing firmware. LOADACS goes to 
the next group of directives. 

J.INIT: {COPY | LOAD | PATCH} TO {CPU|IPU} FOR {ACS|WCS} FAILED VERIFICATION, 

ADDRESS addr DIFFERS { PROM \ filename } = contents 

{ACS|WCS} = contents 

The following message is displayed when the firmware file cannot be assigned. A 
decimal error number (RMxjc) is returned by H.REMM. LOADACS goes to the next 
group of directives. 

J.INIT: CANNOT LOAD {ACS|WCS} FOR {CPU|IPU} - UNABLE TO ASSIGN filename 
ERROR RMU 

The following message is displayed when an invalid value is found in a firmware file. 

The file’s name, the invalid value, and the address of the value are displayed. 

LOADACS goes to the next group of directives. 

J.INIT: CANNOT { LOAD | PATCH} {ACS|WCS} FOR {CPU|IPU} - INVALID VALUE 
value IN filename AT ADDRESS addr 

The following message is displayed when an ENABLE directive is used in a group of 
WCS directives. The ENABLE directive is valid for ACS only. Remove the 
ENABLE directive. 

J.INIT: ENABLE COMMAND IS INVALID WHEN WCS ACTION IS SPECIFIED 

The following message is displayed when there is no WCS to load. LOADACS goes 
to the next group of directives. 

J.INIT: CANNOT { LOAD | PATCH} {CPU|IPU} WCS - NO WCS PRESENT 

The following message is displayed if a previous action to a processor failed. J.INIT 
cannot enable the ACS since that firmware has not been properly loaded. LOADACS 
goes to the next group of directives. 

J.INIT: CANNOT ENABLE {CPU|IPU> ACS - PREVIOUS ACTION TO THIS PROCESSOR FAILED 

The following message is displayed if the processor is in the ROMSIM mode, i.e., 
writing to ACS results in a System Check Trap. LOADACS goes to the next group 
of directives. 

J.INIT: CANNOT { COPY | LOAD | PATCH } {ACSICPU} FOR {CPUIIPU} - {CPU|IPU} IS IN ROMSIM MODE 
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12.8.2 DUMPACS Error Conditions and Messages 

The following DUMPACS error messages are written to the device assigned to LFC 
UT. 

The following message displays when the last directive entered is invalid. Enter a 
valid directive at the DMP prompt. 

INVALID COMMAND 

The following message displays when the last directive entered contains an invalid 
processor mnemonic. The valid mnemonics are CPU and IPU. 

INVALID PROCESSOR MNEMONIC 

The following message displays when the last directive entered contains an invalid 
memory type. Valid memory types are PROM, ACS, and WCS. 

INVALID MEMORY TYPE 

The following message displays when the starting address specified in the DUMP 
directive is invalid. Re-enter the directive with a new starting address. 

INVALID START ADDRESS 

The following message displays when the ending address specified in the DUMP 
directive is invalid. Re-enter the directive with a new ending address. 

INVALID END ADDRESS 

The following message displays when the directives can be used only on a 32/67 
machine. 

THIS MACHINE IS NOT A 32/67 - CAN NOT DO IT 

The following message displays when the IPU was not configured in the system at 
SYSGEN time. 

IPU NOT CONFIGURED IN SYSTEM 

The following message displays when the IPU is offline. IPU directives are not 
executed until the IPU is marked online. 

IPU MARKED OFFLINE 

The following message displays when DUMPACS cannot open LFC SLO to write 
required data. If the SLO default is used in this case, a system problem exists. 

CAN NOT OPEN SLO 

The following message displays when an incorrect address is found in the firmware 
file. Correct and reassemble the firmware file, then re-enter the directives. 

BAD ADDRESS addr FOUND IN FIRMWARE FILE 

The following message displays when the firmware file cannot be assigned. A 
decimal error number (RMxr) is returned by H.REMM. 

UNABLE TO ASSIGN FILE - ERROR RMxr 
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The following message displays when a parameter in the last directive is invalid. 
Correct the parameter and re-enter the directive. 

INVALID PARAMETER 

The following message displays when the processor used in the directive does not 
have WCS. 

THERE IS NO WCS ON THIS PROCESSOR 
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1 3 Volume Formatter (J.VFMT) 


13.1 Introduction 

The Volume Formatter (J.VFMT) formats volumes (disks) for use with MPX-32 and 
allows you to manage disk media online. With online media management directives, 
you can initialize media and perform media flaw editing. 

When formatting volumes, J.VFMT FORMAT directive processing creates the 
following data structures on each volume: 

Volume descriptor 

Resource descriptor allocation bit map (DMAP) 

DMAP descriptor 

File space bit map (SMAP) 

SMAP descriptor 

System image descriptor 

General allocatable resource descriptors 

Allocatable resource descriptors map 

Root directory 

Root directory descriptor 

DMAP deallocation file 

DMAP deallocation file descriptor 

SMAP deallocation file 

SMAP deallocation file descriptor 

Media deallocation file 

Media deallocation file descriptor 

13.2 General Description 

J.VFMT operates in either of two environments: a fully functional MPX-32 system or 
a starter system generated by the System Distribution Tape (SDT) when SYSINIT 
activates J.VFMT from tape. 

When EPL is performed from the SDT, file system support is not present in the form 
of a usable disk volume. To format a system volume, SYSINIT makes a static 
assignment indicating the system image is coming from tape, and a system image file 
is read from the SDT. Therefore, the IMAGE option for the FORMAT directive in 
J.VFMT must not be specified. 


13.3 Logical File Code Assignments 

Logical file codes required by J.VFMT are described in this section and summarized 
in Table 13-1. 

13.3.1 Audit Trail (SLO) 

As J.VFMT processes directives, it produces listed output for operations it performs. 
The LFC for the audit trail is SLO. 
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13.3.2 Directive Input (SYC) 

Directive input is assigned to J.VFMT from logical file code SYC. 


Table 13-1 

J.VFMT Logical File Code Assignments 


Input/Output 

Logical 

Default assignments 

Description 

File Code 

for J.VFMT 

Audit trail 

SLO 

SASSIGN SLO TO LFC=UT 

Directive input 

SYC 

$ ASSIGN SYC TO SYC 


13.4 Using J.VFMT 

J.VFMT formats unmounted volumes for use with MPX-32. An attempt to run 
J.VFMT on a mounted volume causes an abort. 

Generally, only one J.VFMT directive verb can be processed for each FMT prompt. 
When the requested function completes, J.VFMT exits and returns to the calling task. 
For example, 

TSM>$ J.VFMT 

FMT>F ORMAT DEV=DM0802 VOL=EXAM MAXRE=3000 CON=Y 
FMT>CON=N 

DEVICE=DM0802 — VOLUME FORMATTING SUCCESSFULLY COMPLETED 
TSM> 

An exception to this is for the INITIALIZE directive. After processing completes for 
this directive, J.VFMT prompts the user for an additional directive. This is useful (and 
required during an SDT activation of J.VFMT) to continue processing with the 
FORMAT directive. 

When run in the batch mode, parameters must be specified in the first input string on 
the directive line. 

In the interactive mode, J.VFMT prompts for more data after the first input string if: 

• required parameters are not specified 

• directive line contains a syntax error 

• the Boolean flag for confirm is not turned off 

If a syntax error occurs, J.VFMT displays an error message and the part of the 
directive line in error. The remainder of the directive line is ignored. However, 
directives and parameters in the directive line before the syntax error occurred are 
processed and need not be respecified. 

To recover from certain errors in the interactive mode, J.VFMT requires specific 
information specified by error message output. In some cases, additional input is not 
accepted until requested. 
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13.4.1 


13.4.1.1 


13.4.1.2 


13.4.1.3 


13.4.2 


Directive Syntax Rules 

The directive line has three parts: 

• Verb 

• Parameters 

• Options 

Blank spaces are legal delimiters between directive line components. 

Verb 

The verb defines the action the utility is to take (such as FORMAT, REPLACE, 

EXIT) and determines the subset of valid options. The verb must be the first item on 
the directive line. 

Parameters 

Parameters are required keywords followed by an equal sign and a value. They are 
entered on the directive line after the verb. Parameters specify what is affected by the 
action of the directive. Parameters have three types of values: 

• Boolean — Values are true (T), false (F), yes (Y), no (N), on (ON), and off (OFF). 
Values true, yes, and on are synonymous. Values false, no, and off are 
synonymous. 

• Numeric — Values are either decimal or hexadecimal numbers. For example, radix 
can be stated using the radix indicators X and N, e.g., X’AB’, N’18’. 

• ASCII string — Values are expressed as strings containing alphanumeric characters. 


Options 

Options are optional keywords followed by an equal sign and a value. If specified, 
options are entered on the directive line after the parameters. Options are used as 
qualifiers (such as ACCESS=, CONFIRM=, IMAGE=). Where applicable, default 
values are provided. See the individual directive descriptions for defaults. 

Directive Line Continuation 

Directive lines can be continued across lines by placing a hyphen (-) as the last 
significant character on the line. This results in a prompt for more input when in the 
interactive mode, and another read when in batch mode or when reading a selected 
file. Each time a directive line is continued, the continuation character is replaced by 
a space. The only restriction is that single names, keywords, or an entire pathname 
must appear on die same line of input. 
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13.4.3 The CONFIRM Parameter 

The CONFIRM parameter is included in the following Volume Formatter directives: 
EDITFMAP, FORMAT, INITIALIZE, NEWBOOT, and REPLACE. This parameter 
allows the user to review the specified values of all parameters and options associated 
with a directive. The user may then change these values before processing the 
directive, or begin processing without making any changes. 

CONFIRM is only valid in interactive mode. In any other mode it is ignored. 

When CONFIRM=Y (the default) is specified for a given directive, a list of that 
directive’s options and parameters (and their specified values) is displayed as soon as 
the directive is entered. To change the values of any of these options or parameters, 
the user must type the option or parameter, an equals sign, and the new value. 
Changing an option or parameter requires the same syntax as specifying it as part of a 
directive. After the changes are entered, all options and parameters are displayed 
again. The directive may then be processed using the new values by entering 
CONFIRM=N. 

Any number of options and parameters may be changed at one time. Changes can be 
made and displayed any number of times. 

The user may also choose to exit Volume Formatter without processing the directive. 
This is done by typing X or EXIT. 

13.5 Accessing the Volume Formatter 

The Volume Formatter can be accessed from a batch file or TSM in the following 
ways: 

$ J.VFMT 

$EXECUTE J.VFMT 

$RUN J.VFMT (valid from the system directory only) 

When logical file code SYC is assigned to a terminal, the FMT> prompt is displayed. 
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13.6 Volume Formatter Directives 


The following directives are supported by J.VFMT. 


Directive 

COPY 

EDITFMAP 

EXIT 

FORMAT 

INITIALIZE 

NEWBOOT 

REPLACE 


Description 

copies a mounted volume to an unmounted volume 
converts flaw definition information from one medium to another 
exits the Volume Formatter utility 
software formats a disk 

prepares a disk for volume formatting by writing new labels to its 
tracks and sectors, and builds a media descriptor (MD) track 

writes a new bootstrap process to a formatted volume 

writes a new default system image and bootstrap to 
a formatted volume 


13.7 COPY Directive 

The COPY directive copies a mounted volume to an unmounted medium. To do this, 
it formats the target medium with the characteristics of the source volume, then copies 
the RDs, directories, and files from the source to the target volume. The target 
medium must be the same disk type as the source. When using this directive with 
HSDP disks, the source and target disks must have the same track and sector 
configuration. 

The COPY directive cannot be specified during SDT processing. 

Syntax 

COPY VOLUME=volname TARGET=mmccss [BRlEF={ YIN}] [DESTROY={ Yl N}] 

V O LUME=volname 

volname is the name of the source volume to copy 
TARGET=mmccss 

mmccss is the device type, channel address, and device subaddress of the 
device where the target medium is located. Valid device types are: 

DM moving head or memory disk 
FL floppy disk 
DF fixed head disk 

[BRIEF={ YIN}] 

If N is specified, COPY writes to SLO a list of the directories and files 
copied and their size. If Y is specified, only the directories are written to 
SLO. However, if a file cannot be copied, its pathname and the 
applicable error code is written to SLO. Default is Y. 
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[DESTROY={ YIN}] 

Y permits J.VFMT to overwrite a formatted target disk. The default is N. 
If the target disk is formatted but Y has not been specified, J.VFMT 
issues a warning message. In batch or command-file mode, J.VFMT then 
aborts to TSM. In interactive mode, J.VFMT follows the warning 
message with the prompt CONTINUE - Y/N?. If the user chooses Y, 
the disk is overwritten. Otherwise, J.VFMT aborts to TSM. 


Notes: 

1. J.VFMT does not copy files in the following cases: 

• source file cannot be allocated for implicit shared read access with no 
previous writers on the file 

• target volume lacks enough contiguous file space for the source file or for 
the directory file 

• source file is in a directory created after the disk copy begins 

• source file or partition is created after processing of its directory begins 

• source file or partition is deleted before its directory entry is processed 

2. Error messages display when: 

• a file or directory cannot be copied 

• an RID is changed 

• a file’s start address is not maintained at the same start address 

• the bootability of a volume is not maintained 

3. General SLO output contains: 

• a list of directories copied 

• a snapshot of the free space on the source volume when COPY is initiated 

• a snapshot of the free space on the target volume when COPY concludes, 
including the amount of contiguous free space 

• disk bus performance information. This includes the number of blocks 
transferred, the elapsed time of the copy, and a bytes per second rate with a 
bus efficiency rating. 

• if BRIEF=N is specified, a list of the files copied and their size 
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13.8 EDITFMAP Directive 

The EDITFMAP directive converts flaw definition information from one medium to 
another. This directive is used for online disk media management. For more 
information about managing disk media online, refer to the Online Disk Media 
Management section in this chapter. 

The EDITFMAP directive executes in either read-only mode or no I/O mode. 

• Use read-only mode when the disk is present and has flaw information available for 
read-only access. To specify this mode include both the DISC and DEVICE 
options with this directive. 

• Use no I/O mode when the disk cannot or need not be read. To specify this mode 
include the DISC option and omit the DEVICE option with this directive. 

The EDITFMAP directive cannot be specified during SDT processing. 

Syntax 

EDITFMAP DIS C=dcode [CONFERM={ YIN }] [DEVlCEwnroccss] [DUM?={ddccss,idl)] 
[FMAP={ YIN}] [ I N CUJDE=mapfile ] [LOAD=(ddccss,id2)] 

D\SC=dcode 

dcode is the disk storage device type code. Refer to Note 1 in the 
INITIALIZE directive section for a list of disk type codes. 

[CONFIRMr {YIN}] 

specifies whether confirmation is required before processing begins. If Y 
is specified, prompts are issued which allow the user to modify options 
and parameters, or start processing. If N is specified, no prompt is issued. 
The default is Y. This option is valid only in interactive mode; it is 
ignored in any other mode. 

[DEVlCE=mwccsi] 

mmccss is the device type, channel address, and device subaddress of the 
device with the media flaw information to edit. Valid device types are: 

DM moving head or memory disk 
FL floppy disk 
DF fixed head disk 
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[DUMP=(<Wccsi,/d7)] 

specifies writing media flaw information in dumped media flaw format to 
a device and assigns an ID to the output. See note 1. 

ddccss is the device mnemonic, channel address and device subaddress. 
The mnemonic can be any magnetic tape mnemonic (M7, M9, 
MT) or floppy disk (FL). 

idl is an identifier (1 to 20 ASCII characters) to record on the 

external medium with the dumped media flaw data. Successive 
single quote marks indicate that idl contains all blanks. 

[FMAP={YIN}] 

Y writes the media flaw map to SLO. The default is N. 

[INCLUDE=m<3/>/i/e] 

mapfile is the pathname of a file containing a media flaw map to include 
in the new media flaw data being generated. Refer to section 13.16.6 for 
a description of the format for a media flaw map entry. 

[ LO AD={ddccss, id2)\ 

specifies read of media flaw information in dumped media flaw format 
from a device. See note 1. 

ddccss is the device mnemonic, channel address and device subaddress. 
The mnemonic can be any magnetic tape mnemonic (M7, M9, 
MT) or floppy disk (FL). 

id2 is an identifier (1 to 20 ASCII characters) to compare to the ID 
recorded on the external medium with the dumped media flaw 
data being read. Successive single quote marks indicate that 
verification of idl is not required. 


Notes: 

1. The LOAD and DUMP identifiers are incompatible with early releases of the 
UDP/DP II MVP that limit identifiers to 4 characters. 


Examples 

The following example converts dumped media flaw data from tape drive M91000 to 
SLO. 

EDI DIS=DC0600 CON=N FMAP=Y LOA= (M91000, FLAWS . D1 ) 

The following example converts flaw definition information from the text file FILE1 
to SLO. 

EDI DIS=DP0080 FMA=Y INC=@RT0 (SYSTEM) FILE1 
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13.9 EXIT Directive 

The EXIT directive exits J.VFMT and returns control to TSM. 

Syntax 
{ EXIT I X } 

13.10 FORMAT Directive 

The FORMAT directive software formats a disk. This directive does not check for 
existing data on the disk, but does check for existing volume structures. 

For all disks, except floppy and memory disks, the disk media must have been 
initialized prior to using the FORMAT directive. This may be accomplished by: 

• using the J.VFMT INITIALIZE directive (MFP SCSI, HSDP, or UDP/DP II 
controllers) 

• running the Level II Diagnostic Media Verification program (HSDP or UDP/DP II 
controllers) 

• running the Level II Diagnostic program (MFP SCSI) 

Syntax 

FORMAT DEVICE -mmccss VOLUME=vo/«awe [ACCESS=ws£rfype([READ] [DELENT] 
[ADD] [TRAVERSE])]... [ALOC=blocks] [B00TFILE=0LD I NEW I bstrap } ] 
[CONHRM=[YIN)] [DESTROYS YIN}] [DETACH={ Y I N }] [ECC={ Y I N}] 
[IMAGE=/mzrgc] [ISIZE=Woc±s] [MAXAU=«mtt] [MAXRES=r</s] 
[MAXROOT=enfr/es] [0\NNER=ownername] [PROJECTGROUP=/?to/] 


DEVICE -mmccss 

mmccss is the device type, channel address, and device subaddress of the 
disk to be formatted. Valid device types are: 

DM moving head or memory disk 
FL floppy disk 
DF fixed head disk 

V O LUME-volname 

volname is a user-specified name for the volume being formatted. This 
name can be 1 to 16 characters. 
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[ACCESS=wrcrtype([READ] [DELENT] [ADD] [TRAVERSE])]... 

specifies the access attributes for the root directory of the volume. Empty 
parentheses, such as ACCESS=OT ( ) indicate no access possible. 

Repeat this option for each usertype desired. If not specified, owner has 
complete access, project group has all but delete access, and others have 
read only and traverse access. 

usertype is one of the following types of users: 

OWNER specifies what access rights the owner has to the 
root directory 

PROJECTGROUP 

specifies what access rights the project group 
has to the root directory 

OTHERS specifies what access rights others have to the 
root directory 


READ 

DELENT 

Add 

Traverse 


permits usertype to read the root directory 
permits usertype to delete entries from the root directory 
permits usertype to add entries to the root directory 
permits usertype to traverse the root directory 


[ALOCsWocks] 

blocks is the number of blocks per allocation unit on the disk being 
formatted. The maximum value for blocks is the number of sectors per 
track. If omitted or set to 0, J.VFMT uses a system default based on the 
disk’s capacity. For information on allocation units, refer to Table 13-2. 

[BOOTHLE={OLD I NEW I bstrap } ] 

specifies the bootstrap to be installed to the disk. If this option is omitted, 
J.VFMT installs the appropriate standard bootstrap. 

OLD specifies the old standard bootstrap. The old standard 

bootstrap is designed for images that require no more than 5 
IOCDs to load. 

NEW specifies the new standard bootstrap. The new standard 
bootstrap is designed for images that require 6 or more 
IOCDs to load. 

bstrap is the pathname of a file containing a nonstandard bootstrap. 

This bootstrap may follow either the old or new style. This 
file must be in absolute load module format. Its maximum 
length is seven 192- word blocks including the load module 
preamble. Note: Do not specify bstrap when J.VFMT is 
activated from an SDT. 

Not all MFP SCSI interfaces support new-style bootstraps. If you specify 
NEW, or a pathname containing a nonstandard bootstrap designed for 
images requiring 6 or more IOCDs, when formatting an MFP SCSI 
interface which does not support the new-style bootstrap, J.VFMT aborts 
to TSM. 

For more information on the old and new standard bootstraps, see Chapter 
5, section 5.2, of this volume. 
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[CONFIRM={YIN}] 

specifies whether confirmation is required before processing begins. If Y 
is specified, prompts are issued which allow the user to modify options 
and parameters, or start processing. If N is specified, no prompt is issued. 
The default is Y. This option is valid only in interactive mode; it is 
ignored in any other mode. 

[DESTROYS YIN}] 

Y permits J.VFMT to overwrite existing volume structures on the disk to 
be formatted. The default is N. If the disk to be formatted contains 
existing volume structures but Y has not been specified, J.VFMT issues a 
warning message. In batch or command-file mode, J.VFMT then aborts 
to TSM. In interactive mode, J.VFMT follows the warning message with 
the prompt CONTINUE - Y/N?. If the user chooses Y, the disk is 
overwritten. Otherwise, J.VFMT aborts to TSM. 

[DETACH={YIN}] 

specifies whether J.VFMT should run as an independent task. If Y is 
specified, J.VFMT displays the current parameters, then detaches from 
the terminal, and returns control to TSM. Formatting continues as usual. 
When it completes, a message displays on the terminal. This option is 
valid only in interactive mode. 

[ECC={ Yl N } ] 

specifies whether disk sectors with correctable data errors are available for 
users to allocate. If Y is specified, users can allocate these sectors. If N 
is specified, J.VFMT marks these sectors as allocated (bad block 
deallocation). The default is N. 

[IMAGE=/mtfgc] 

image is the pathname of a file containing a system image. If the IMAGE 
option is not specified and J.VFMT is disk activated, the target volume 
will not be bootable. Note: Do not specify this option when J.VFMT is 
activated from an SDT. 

[ISIZE=Wocfo] 

blocks is the number of blocks allocated for the system image. The 
default is 600. 

[MAXAUsww'fs] 

units is the number of allocation units on the disk. This number’s default 
value depends on the ALOC -blocks option or the default granularity if 
blocks is not specified. If specified, units must be less than the number of 
allocation units physically available. 

[MAXRES =rds] 

rds is the number of resource descriptors (RD) to reserve disk space for. 
One RD is required for every file defined on the volume. The default for 
memory disks or floppy disks is 70. All other devices default to 1000. 

[MAXROOT=e/irrics] 

entries is the number of entries in the root directory to reserve disk space 
for. This number can be modified to accommodate various hashing 
algorithms. The default is 100. 


MPX-32 Reference Volume III 


13-11 




FORMAT Directive 


13.11 


[0\NMER=ownername] 

ownername is the owner name to associate with the volume. This name 
is recorded in the volume descriptor. If omitted, J.VFMT uses the owner 
name associated with the J.VFMT task. 

[PR O JECTGROUP=pro / ] 

proj is the project group name to associate with the volume. This name is 
recorded in the volume descriptor. If omitted, J.VFMT uses the project 
group name associated with the J.VFMT task. 


Table 13-2 
Allocation Units 


Capacity 

Drive type 

Default sectors per unit 

N/A 

floppy moving head 

i 

N/A 

memory disk 

1 

5 MB 

fixed head 

i 

32 MB 

cartridge module 

2 

40 MB 

moving head 

2 

64 MB 

cartridge module 

2 

80 MB 

moving head 

2 

96 MB 

cartridge module 

2 

160 MB 

moving head 

4 

300 MB 

moving head 

4 

337 MB 

moving head 

5 

340 MB 

moving head 

4 

447 MB 

moving head 

5 

500 MB 

moving head 

5 

600 MB 

moving head 

10 

687 MB 

moving head 

9 

700 MB 

moving head 

7 

800 MB 

moving head 

9 

850 MB 

moving head 

9 

858 MB 

moving head 

9 

1230 MB 

moving head 

11 


INITIALIZE Directive 

The INITIALIZE directive prepares a disk for volume formatting by writing new track 
and sector labels, and building the media descriptor track. This directive is used for 
online disk media management. For more information about managing disk media 
online, refer to the Online Disk Media Management section in this chapter. 

Because this directive overwrites the disk, for HSDP disk media save any existing 
vendor flaw information to a device before initialization or by specifying the DUMP 
option with this directive. 
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This directive does not initialize the two cylinders reserved for diagnostic use or the 
cylinder reserved for hardware vendor use. 

Executing the INITIALIZE directive can be a lengthy process. Depending on the disk 
capacity, the directive can take in the order of 30 to 45 minutes to complete. In the 
interactive mode, J.VFMT writes status information to the terminal, allowing the user 
to follow its progress. For MFP SCSI media, no status information is generated, so 
the user must allow an appropriate time for completion. 

With the INITIALIZE directive you can: 

• read media flaw information from an ASCII text file by specifying the INCLUDE 
option 

• read dumped flaw information from a device by specifying the LOAD option 

• check for additional media flaws on a disk by specifying PATTERN=Y 

• initialize a disk for dual port use by specifying DUAL=Y 

• write new media flaw information in dumped media flaw format with the DUMP 
option 

• write a media flaw map to SLO by specifying FMAP=Y 

• perform sector substitution by specifying SSUB=Y. (HSDP disk only) 

Syntax 

INITIALIZE DEVlCE=wmccss [CONFIRM:: { YIN (] [DESTROY={ Y I N }] [DISC sdcode] 
[DUAL={YIN}] [D\JMP=(ddccss,idl)] [FMAP={ YIN}] [INCLUDE=ma/^/e] 
[LOAD =(ddccss,id2)] [PATTERN= { YIN } ] [SSUB= { Y I N } ] 


DEVICE =mmccss 

mmccss is the device type, channel address, and device subaddress of the 
disk to be initialized. Valid device types are: 

DM moving head or memory disk 
FL floppy disk 
DF fixed head disk 

[CONFIRMS YIN}] 

specifies whether confirmation is required before processing begins. If Y 
is specified, prompts are issued which allow the user to modify options 
and parameters, or start processing. If N is specified, no prompt is issued. 
The default is Y. This option is valid only in interactive mode; it is 
ignored in any other mode. 

[DESTROYS Y | N}] 

Y permits J.VFMT to overwrite a formatted disk. The default is N. If 
the disk to be initialized is formatted but Y has not been specified, 
J.VFMT issues a warning message. In batch or command-file mode, 
J.VFMT then aborts to TSM. In interactive mode, J.VFMT follows the 
warning message with the prompt CONTINUE - Y/N?. If the user 
chooses Y, the disk is overwritten. Otherwise, J.VFMT aborts to TSM. 
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[DISC =dcode] 

dcode is the disk device type code. Refer to Note 1 for a list of disk type 
codes. Note: This option is required when the target disk is an HSDP 
media that has been sector substituted. 

[DUAL={YIN}] 

Y writes track and sector labels with the dual port option bit set in the 
DATR field of each label. The default is N. 

[DUMP=(rfJccs5,/</f )] 

specifies writing media flaw information in dumped media flaw format to 
a device and assigns an ID to the output. See note 2. 

ddccss is the device mnemonic, channel address and device subaddress. 
The mnemonic can be any magnetic tape mnemonic (M7, M9, 
MT) or floppy disk (FL). 

idl is an identifier (1 to 20 ASCII characters) to record on the 

external medium with the dumped media flaw data. Successive 
single quote marks indicate that idl contains all blanks. 

[FMAP={YIN}] 

Y writes a media flaw map to SLO after the disk is initialized. The 
default is N. 

[ I N CL\JT>E-mapfile] 

mapfile is the pathname of a file containing a media flaw map to include 
in the new media flaw data being generated. Refer to section 13.16.6 for 
a description of the format for a media flaw entry. 

[LOAD=(dtfccss,/c/2)] 

specifies read of media flaw information in dumped media flaw format 
from a device. See note 2. 

ddccss is the device mnemonic, channel address and device subaddress. 
The mnemonic can be any magnetic tape mnemonic (M7, M9, 
MT) or floppy disk (FL). 

id2 is an identifier (1 to 20 ASCII characters) to compare to the ID 
recorded on the external medium with the dumped media flaw 
data being read. Successive single quote marks indicate that 
verification of id2 is not required. 

[PATTERNS YIN}] 

Y tests the disk for flaws by writing a worst-case pattern to the disk, then 
reading and comparing it. Any errors detected are added to the media 
flaw information. The default is N. 

[SSUB={YIN|] 

Y substitutes the spare sector on each of the disk’s tracks for a single 
flawed sector on that track. This option is valid only for disks with 
HSDP disk interfaces. It is ignored when intializing disks with any other 
type of disk interface. The default is N. 


13-14 


Volume Formatter (J.VFMT) 



INITIALIZE Directive 


Notes: 


1. The disk device type codes valid for the INITIALIZE and EDITFMAP directives 
are as follows. 


Disk 

Type Code 

Controller 

Model 

Number 

Description 

DP0080 

HSDP 

8138 

CDC 80 MB RSD 

DP0337 

HSDP 

8887 

Fujitsu 337 MB Winchester 

DP0474 

HSDP 

8884 

Fujitsu 474 MB Winchester 

DP0500 

HSDP 

8812 

CDC 500 MB EMD 

DP0689 

HSDP 

8889 

Fujitsu 689 MB Winchester 

DP0800 

HSDP 

8881 

NEC 800 MB Winchester 

DP0850 

HSDP 

8813 

CDC 850 MB EMD 

DP0858 

HSDP 

8888 

CDC 858 MB XMD 

DP1230 

HSDP 

8814 

CDC 1.23 GB EMD 

DC0080 

UDP/DP II 

var. 

CDC 80 MB disk 

DC0160 

UDP/DP II 

8127 

CDC 160 MB fixed media 

DC0300 

UDP/DP II 

9346 

CDC 300 MB removable 

DC0340 

UDP/DP II 

8858 

CDC 340 MB Winchester 

DC0600 

UDP/DP II 

8155 

CDC 675 MB fixed media 

SD0150 

MFP SCSI 

8820 

CDC 150 MB Wren III SCSI 

SD0300 

MFP SCSI 

8828 

CDC 300 MB Wren IV SCSI 

SD0700 

MFP SCSI 

8833 

CDC 700 MB Wren V SCSI 


For UDP/DP II, the SYSGEN disk type codes MHxxt can be used instead of 
DCOxxr. This enables compatibility with existing disk type codes defined in the 
SYSGEN file. 

2. The LOAD and DUMP ids are incompatible with early releases of the UDP/DP 
II Media Verification Programs that limit the id field to 4 characters. 

Examples 

The following example initializes the disk on device DM0800 for multiport use. 
Before initialization, it writes the disk’s existing media flaw information to device 
FL7EF0 and assigns it an ID of blanks. After initializating the disk, J.VFMT writes a 
media flaw map to SLO. 

In non-interactive mode, J.VFMT aborts if the target device, DM0800, is found to be 
software formatted. In interactive mode, J.VFMT prompts the user to continue if the 
the target device is formatted. 

INI DEV=DM0800 DUAL=Y DUMP= (FL7EF0 , ' ' ) FMAP=Y 
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The following example initializes the disk type DP 05 00 on device DM0C00. It 
includes the media flaw map in MAP500 file and media flaw information from device 
M91000 in the new Media Descriptor (MD) track. Any existing structures on the 
disk are overwritten. 

INIT DEV=DM0C00 DES=Y DISC=DP0500 INC=MAP500- 
LOA= (MT91000, RTSW) 



13.12 NEWBOOT Directive 

The NEWBOOT directive replaces the bootstrap on a previously formatted volume. 
For this volume to be bootable, you must have specified the IMAGE option when 
formatting the disk with J.VFMT. See the FORMAT directive. The NEWBOOT 
directive is invalid when J.VFMT is activated from an SDT. 


Syntax 

NEWBOOT DEVlCE=mmccss MOUJUE-volname [BOOTFILE= { OLD I NEW I bstrap } ] 
[CONFIRM=( YIN}] 

DEVICE -mmccss 

mmccss is the device type, channel address, and device subaddress of the 
disk whose bootstrap program is being replaced. Valid device types are: 

DM moving head or memory disk 
FL floppy disk 
DF fixed head disk 

V O \JJME-volname 

volname is the name of the target volume. 

[BOOTFILEs { OLD I NEW I bstrap } ] 

specifies the bootstrap to be installed to the disk. If this option is omitted, 
J.VFMT installs the appropriate standard bootstrap. 

OLD specifies the old standard bootstrap. The old standard 

bootstrap is designed for images that require no more than 5 
IOCDs to load. 

NEW specifies the new standard bootstrap. The new standard 
bootstrap is designed for images that require 6 or more 
IOCDs to load. 

bstrap is the pathname of a file containing a nonstandard bootstrap. 

This bootstrap may follow either the old or new style. This 
file must be in absolute load module format. Its maximum 
length is seven 192-word blocks including the load module 
preamble. 

Not all MFP SCSI interfaces support new-style bootstraps. If you specify 
NEW, or a pathname containing a nonstandard bootstrap designed for 
images requiring 6 or more IOCDs, for an MFP SCSI interface which 
does not support the new-style bootstrap, J.VFMT aborts to TSM. 
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For more information on the old and new standard bootstraps, see Chapter 
5, section 5.2, of this volume. 

[CONFIRMS {Y IN}] 

specifies whether confirmation is required before processing begins. If Y 
is specified, prompts are issued which allow the user to modify options 
and parameters, or start processing. If N is specified, no prompt is issued. 
The default is Y. This option is valid only in interactive mode; it is 
ignored in any other mode. 


13.13 REPLACE Directive 

The REPLACE directive writes a new default system image and bootstrap to a 
formatted volume. Use this directive to modify system image data in the volume 
descriptor. The volume can already contain a default system image. 

Syntax 

REPLACE DEVlCE=mmccss IMAGE=/wuge WOLUME-volname 

[BOOTFILE={OLD I NEW I bstrap } ] [CONFIRM= {YIN}] 

DEVICE =mmccss 

mmccss is the device type, channel address, and device subaddress to 

write a new system image and bootstrap. Valid device types are: 

DM moving head or memory disk 

FL floppy disk 

DF fixed head disk 

\MAGE=image 

image is the pathname of a file containing a system image. 

V O L\JME=volname 

volname is the name of the target volume. 

[BOOTFILE={ OLD I NEW I bstrap } ] 

specifies the bootstrap to be installed to the disk. If this option is omitted, 

J.VFMT installs the appropriate standard bootstrap. 

OLD specifies the old standard bootstrap. The old standard 

bootstrap is designed for images that require no more than 5 
IOCDs to load. 

NEW specifies the new standard bootstrap. The new standard 
bootstrap is designed for images that require 6 or more 
IOCDs to load. 

bstrap is the pathname of a file containing a nonstandard bootstrap. 

This bootstrap may follow either the old or new style. This 
file must be in absolute load module format. Its maximum 
length is seven 192- word blocks including the load module 
preamble. Note: Do not specify bstrap when J.VFMT is 
activated from an SDT. 
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Not all MFP SCSI interfaces support new-style bootstraps. If you specify 
NEW, or a pathname containing a nonstandard bootstrap designed for 
images requiring 6 or more IOCDs, when using REPLACE with an MFP 
SCSI interface which does not support the new-style bootstrap, J.VFMT 
aborts to TSM. 

For more information on the old and new standard bootstraps, see Chapter 
5, section 5.2, of this volume. 

[CONHRM={YIN}] 

specifies whether confirmation is required before processing begins. If Y 
is specified, prompts are issued which allow the user to modify options 
and parameters, or start processing. If N is specified, no prompt is issued. 
The default is Y. This option is valid only in interactive mode; it is 
ignored in any other mode. 


13.14 J.VFMT Errors 

The following error messages are issued by J.VFMT: 


Code Description 

VF01 ERROR HAS OCCURRED. SEE SLO FILE FOR EXPLANATION. 

VF02 OPEN FAILURE ON AUDIT TRAIL DEVICE/FILE 

VF03 EOF/EOM ON AUDIT TRAIL DEVICE/FILE 

VF04 I/O ERROR ON AUDIT TRAIL DEVICE/FILE 


13.15 Examples 

The following example formats a non-bootable disk using the name MASTER. It is 
located on device DM0800, and space for 40 00 resource descriptors is reserved. 

FMT>FORMAT DEV=DM0800 VOL=MASTER MAXRE=4000 


The following example writes the nonstandard bootstrap specified by the BOOTFILE 
parameter to volume NEW located on device DM0802. All parameters will be 
displayed. Confirmation will have to be reset to false (i.e., CON=N) to continue the 
formatting process. 

FMT>NEWBOOT DEV=DM0802 VOL=NEW- 
FMT_BOOTFILE=@SYSTEM (USER1) BOOTSTRAP- 
FMT CON=Y 


The following example changes the default system image on volume MASTER4 
located on device DM0804 to the system image defined in file BOOT located on 
volume SYSTEM in directory USER1. The appropriate standard bootstrap is also 
written to the disk. 

FMT>REPLACE DEV=DM0804 VOL=MASTER4- 
FMT IMA=@SYSTEM (USER1 ) BOOT 
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The following example formats a disk using the name MASTER. It is located on 
device DM0800, the owner has complete access to the volume, the project group has 
read and add access to the volume, and other users have read access to the volume. 

FMT>FORMAT DEV=DM0800 VOL=MASTER- 
FMT_ACC=OW(R A D T) - 
FMT_ACC=PR(R A )- 
FMT ACC=OT(R) 


1 3.1 6 Online Disk Media Management 

To manage disk media online, use the J.VFMT INITIALIZE and EDITFMAP 
directives. These directives provide media initialization and media flaw editing for the 
following disk interfaces: 

• universal disk processor (UDP) 

• disk processor II (DP II) 

• high speed disk processor (HSDP) 

Media management using J.VFMT is generally equivalent to the CONCEPT/32 
Diagnostic Facility Level II Media Verification Program (MVP) for these disk 
interfaces. 

For small computer system interface (SCSI) disks, J.VFMT provides limited media 
management capabilities. Refer to the Managing SCSI Disks section later in this 
chapter for more information. 

The following sections define media management terminology and describe how to 
initialize disks and manage media flaw information. 


13.16.1 Media Management Terminology 

This section defines the terms used in following discussions of media management 
directives and procedures. It also notes where HSDP or UDP/DP II use different 
terms for similar structures. 

Media flaw is a physical defect on a disk. The term media flaw is interchangeable 

with the term media defect. This chapter uses flaw , except where defect 
is already part of a data structure name. 

Vendor flaw information describes disk media flaws detected by the vendor during 
factory testing. This information is usually recorded on each track of the 
disk in a structure called a vendor label. HSDP can read vendor flaw 
information with the Read Vendor Label command. UDP/DP II do not 
have this capability. 

Media flaw information describes a media flaw in its raw or unformatted track 
location. This raw definition is used internally by J.VFMT when 
processing flaws and most precisely describes the actual location of the 
flaw on the disk. J.VFMT converts all flaw formats to this format for 
processing and converts them to the requested output format after 
processing. 
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Media deallocation data lists the disk sectors that have media flaws or are otherwise 
reserved. This data (or data lists) is recorded on the media descriptor track 
in a prescribed format and is used in bad block deallocation. HSDP refers 
to this information as the media flaw map and UDP/DP n uses the term 
media descriptor. 

Media descriptor (MD) track contains media deallocation data. It is built by the 
INITIALIZE directive or the MVP and is usually located on the next-to- 
last track of the third-from-last cylinder. An absolute sector pointer to its 
location is inserted in word 3 of track label 0. 

Flaw definition information is also contained elsewhere on disk in a 
format different from the media deallocation data. For UDP/DP II, this 
alternate format is called flaw data and is located on the MD track. For 
HSDP, this is the vendor defect table entries and is located on the track 
next to the MD track. 

Media flaw map is a text file that contains media flaw information in ASCII. This 

map can be written to SLO by specifying the DUMP or INCLUDE option 
with the INITIALIZE or EDITFMAP directives. Note that the HSDP 
uses this same term to refer to the contents of the MD track. 

Dumped media flaw data is media flaw information written to tape or floppy disk in 
a format common to all media management processors (i.e., HSDP MVP, 
UDP/DP II MVP, and J.VFMT). The HSDP MVP refers to this format as 
the dumped vendor defect table and the UDP/DP II MVP refers to it as 
saved flaw data. 


13.16.2 Initializing Media 

Disks can be initialized in preparation for volume formatting by using the 
INITIALIZE directive. This directive writes new labels to a disk’s tracks and sectors 
and builds the MD track. 

If media flaw information is available for the disk, J.VFMT uses it when building the 
new MD track. This media flaw information may be either vendor flaw information 
input to the directive or an MD track already existing on the disk. 

If media flaw information is unavailable, INITIALIZE writes a worst-case data pattern 
to the disk and reads the disk to check it for errors. If any additional media flaws are 
detected, J.VFMT adds them to the new MD track. 

The INITIALIZE directive does not initialize the two cylinders reserved for diagnostic 
use or the cylinder reserved for hardware vendor use. 
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13.16.2.1 Disk I/O Caution During Initialization 

With UDP/DP II, tasks should not attempt disk I/O to another channel subaddress 
while the controller is processing an INITIALIZE directive. Tasks attempting such I/O 
may be aborted or cause the system to hang. If running on another device subaddress 
on the system disk channel, hold the date/time save task (J.DTSAVE) with the 
OPCOM HOLD directive before initializing a disk. 

If J.VFMT detects that I/O may be attempted to another channel subaddress, it issues 
the following warning message: 

PRECAUTION: ENSURE THAT ALL I/O TO OTHER DISC 

SUBADDRESSES ON CHANNEL XX IS QUIESCENT BEFORE 
CONTINUING 

When executing in interactive mode, this is followed by a prompt to continue or abort 
processing. Enter Y to continue processing or N to abort with a VF01 error and 
message GEN.M062. When in batch mode, the following warning message is written 
to SLO and processing aborts: 

BATCH MODE EXECUTION OF INITIALIZE DIRECTIVE TO 
UDP/DPII MEDIA DENIED. 

POTENTIAL FOR OTHER I/O ACTIVITY ON TARGET DISC CHANNEL 
DETECTED. 

13.16.3 Editing Media Flaw Data 

Flaw definition information can be converted from one medium to another with the 
EDITFMAP directive. This directive executes in two modes: read-only mode and no 
I/O mode. 

• Use read-only mode when the disk is present and has flaw information available for 
read-only access. 

• Use no I/O mode when the disk cannot or need not be read. 


13.16.3.1 Read-Only Mode 

To specify read-only mode, include both the DISC and DEVICE options with the 
EDITFMAP directive. 

With HSDP, this mode is used primarily to read vendor labels from a new disk 
without writing to the disk. In addition, this mode is useful when archiving, since 
vendor flaw information can be written to an external device in dumped media flaw 
format. It can also be used to obtain a hardcopy listing of a disk’s vendor flaw 
information to compare to its vendor-supplied hardcopy listing. 
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With UDP and DP II, read-only mode is used primarily to perform a trial pass on the 
disk’s existing MD track before using the INITIALIZE directive. Perform this trial 
pass before initializing any disk verified with the diagnostic MVP. Because previous 
MVP revisions for UDP/DP II vary in how they handle entries to the MD track, the 
INITIALIZE directive is not compatible with all MVP revisions. Use the EDITFMAP 
directive to identify discrepancies between the MVP-built MD track and J.VFMT’s 
interpretation of this information. 

If discrepancies are detected, do not use the information in the MVP-built MD track. 
Instead, input either vendor flaw information or the dumped media flaw data to the 
INITIALIZE directive. To do this, specify either the LOAD or INCLUDE option with 
the INITIALIZE directive. 

13.16.3.2 No I/O Mode 

To specify no I/O mode, include the DISC option and omit the DEVICE option with 
the EDITFMAP directive. 

This mode is used primarily with the UDP/DP II or for removable media. Because 
these cannot read vendor flaw labels, you must manually enter vendor flaw 
information from a hardcopy vendor flaw listing supplied with the disk. Enter this 
vendor flaw information using a text editor and store it unnumbered in an MPX-32 
file. Then use the EDITFMAP directive to process this input file and produce the 
requested outputs. 

No I/O mode is useful for converting media flaw information from one format to 
another. For example, it can convert ASCII vendor flaw information in a file to 
dumped media flaw data on a floppy disk. The floppy disk could then be used to 
enter media flaw data during an SDT boot to initialize and format a single-disk UDP 
system. 


13.16.4 Special Considerations During SDT Boot 

The EDITFMAP directive is not available during SDT boot. Any attempt to use it 

causes processing to end and an error message is written to SLO. 

The INITIALIZE directive is available but has the following considerations: 

• the PATTERN option is not available 

• the FMAP option writes SLO directly to an available line printer, instead of 
spooling it to disk 

• LOAD and DUMP must specify different device addresses if both options are 
included with the directive 

• devices specified in the LOAD and DUMP options must be online, ready, and 
correctly specified before you respond CONFIRM=N 
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13.16.5 Managing SCSI Disks 

Media management of SCSI disks differs from media management of UDP/DP II and 

HSDP media as follows: 

• the EDITFMAP directive is not available for SCSI disks. The intelligent SCSI disk 
controller performs this function differently and independently. 

• CDC Wren III, IV, and V disks can be initialized using the J.VFMT INITIALIZE 
directive and a subset of its options. Options available with SCSI disks are 
DEVICE, DESTROY, and DISC. Following is an example using the SCSI syntax: 

INI DEV=DM7E00 DES=Y DISC=SD0700 

• SCSI disks other than CDC Wren III or IV can be initialized using the SCSI Disk 
Utility’s (SDUTIL’s) FORMAT directive. Refer to the SDUTIL documentation in 
Volume IV of the MPX-32 Reference Manual for this utility’s syntax and use. 


13.16.6 Media Flaw Map Format 

Media flaw map format is an ASCII format that enables you to track the exact status 
of the disk media and to perform media maintenance. The media flaw map can be 
output to a file, edited, and then input to a media management function. 

The media flaw map is comprised of flaw definition entries listed one per line in a 
format similar to the hardcopy listing provided by the vendor. Each flaw definition 
must be numerically higher than the previous one. In each definition: 

• all values are decimal numbers 

• an asterisk (*) indicates that the entry was flagged as a defective track by the 
vendor 

• a C as the first nonblank character indicates a comment line. These can be included 
anywhere in a flaw map file. 

• any number of blanks may precede the entry or separate the fields within it 


The format for a flaw definition is: 

[*] cylnum {bl, } hdnum {bl, } posi {bl, ) len 

[*] indicates that the entry is a vendor-defined defective track 

(bl, } required field delimiter, either one or more blanks or a comma 

cylnum the cylinder number of the flaw definition 

hdnum the head number of the flaw definition 

posi the byte position of the flaw from the track index 

len the length in bytes of the flaw definition 
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14.1 General Description 

Volume Compress (J.DSCMP) moves resource segments on a mounted volume to 
make the volume’s free space contiguous. It is a privileged system administrator task. 

J.DSCMP consolidates free disk space by moving resource segments to one end of a 
mounted volume and free space to the other end. When activated, J.DSCMP 
calculates the total free space available on disk and uses it to set the size or location of 
the following logical structures: 

• vacate area — the area that J.DSCMP attempts to clear of resource segments. It is 
located at the high end (high physical block numbers) of the disk and is equal in 
size to the total free space available. 

• pack area — the area where J.DSCMP moves and packs the resource segments. It 
is located at the low end (low physical block numbers) of the disk and is equal in 
size to the total allocated space on the disk. 

• bound — separates the vacate area and the pack area. J.DSCMP calculates the 
location of the bound as the highest physical block number minus the total free 
space available on disk. 

After locating the bound, J.DSCMP compresses a volume in two phases. 

14.1.1 Phase One 

In phase one, J.DSCMP attempts to fill the available contiguous free space in the pack 
area with resource segments from the vacate area. To do this, J.DSCMP compiles a V 
list (list of the resource segments in the vacate area), ordered from largest to smallest. 
For each segment in the V list, if there is sufficient contiguous free space in the pack 
area, J.DSCMP moves the segment below the bound and removes the segment from 
the V list. If the contiguous free space is insufficient, the segment remains in the V 
list for phase two. Phase one ends when J.DSCMP reaches the end of the V list. 

If the V list is empty, compression is complete. Otherwise, phase two begins. 

14.1.2 Phase Two 

In phase two, J.DSCMP moves segments within the pack area to the low end of the 
disk until sufficient free space is available to move a segment in the V list below the 
bound. This consolidates resource segments at the low end of the disk and free space 
above the bound. Phase two continues until the V list is empty or the migrating free 
space moves above the segment with the highest physical address in the V list. 
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During compress, J.DSCMP does not move a resource segment if the segment: 

• is allocated 

• is not a permanent file (i.e., is a static or dynamic partition) 

• was created with a specific start sector 

• contains the RD for a directory 

• contains the default image 

• is being restored 

• is a fast file 

• has an entry in the memory resident descriptor table (MDT) 

• is larger than the available free space in the pack area 

The bound is adjusted for entries in the SMAP deallocation file. For every segment 
entry that is within the vacate area, the bound is lowered by that segment size. 

J.DSCMP is a multi-copy task. However, only one copy at a time should be run on 
the same volume. 

J.DSCMP uses standard MPX-32 I/O services to manipulate the data on the disk. All 
allocations and I/Os are performed in the wait mode with immediate denial. 


14.1.3 Performance 

Following is a list of performance considerations: 

• J.DSCMP can be run while the volume is in use. However, compression is most 
effective when volume use is minimal. 

• When compressing the system disk, compression results are better if M.ERR, 
M.PRJCT, M.ACCNT and M.KEY are not allocated. To do this, set control switch 
4 when rebooting the system. 

• Compression results are better if the disk to be compressed does not contain the 
swap file. Remove the swap file by specifying a swap file size of 0 at SYSGEN. 


14.2 Logical File Code Assignments 

Logical file codes required by J.DSCMP are summarized in Table 14-1. 


Table 14-1 

Volume Compress Logical File Code Assignments 



Logical 

Default Assignments 

Description 

File Code 

for J.DSCMP 

Error messages 

ERR 

$ ASSIGN ERR TO LFC=UT 

Informative messages 

OUT 

$ASSIGN OUT TO LFC=UT 
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14.3 Using Volume Compress 

J.DSCMP is called from TSM. 

Syntax 

$J.DSCMP volname [STAtI [LISt][NOMOVE]] 

volname is the name of the mounted volume to be compressed 
STAT displays the current disk status. The volume is not compressed. 

LIST requests a list of moved segments (V and P segments) while compressing 

the volume. See Figure 14-1 for a sample list. 

NOMOVE requests a list of nonmovable segments (N segments) while compressing 
the volume. The segments remain in the vacate area. 


14.3.1 Disk Status Report 

J.DSCMP writes a disk status report to LFC OUT before and after compressing the 
volume or when the STAT option is specified in the J.DSCMP command. The disk 
status is displayed in the following format: 

VOLUME= volume 


TOTAL NUMBER OF BLOCKS (DEC) blocks 

TOTAL FREE SPACE (DEC,PCT OF TOT) total tpercent 

LARGEST CONTIGUOUS FREE AREA (DEC,PCT OF FREE) free fpercent 


blocks 

total 

tpercent 

free 

fpercent 


is the decimal number of blocks on the disk 

is the decimal number of free blocks on disk 

is the percent of blocks on disk that are free 

is the decimal number of blocks in the largest contiguous free area 

is the percent of free blocks on disk that are in the largest contiguous free 
area. 100 indicates that all free space is contiguous. 


14.3.2 Segment Report 

If the LIST and/or NOMOVE options are specified. J.DSCMP displays a list of 
moved and/or nonmovable segments during volume compression. For each resource 
segment, the segment report lists the following: 

• type (TYP) code that identifies whether and where the segment was moved 

• original beginning and end sector numbers 

• post-move beginning and end sector numbers 

• RD address 

• segment definition of the RD that was moved 

• directory and resource where segment is located 
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Figure 14-1 shows a sample segment report that was requested specifying both LIST 
and NOMOVE. If only LIST is specified, the report lists only the V and P segments. 
If NOMOVE is specified, the report lists the N segments. 



TYP 

ORIG BEG 

ORIG END 

NEW BEG 

NEW END 

RD ADDR 

SEG 

DIRECTORY 

RESOURCE 

N 

00013FEC 

0001404F 

MED. MAN. 

SEGMENT 





N 

00014050 

00014117 

MED. MAN. 

SEGMENT 





N 

00014118 

0001417B 

MED. MAN. 

SEGMENT 





N 

000012E6 

000012EF 

NOT PERM. 

FILE 

00000026 

01 

A. 

SOURCE 

V 

0000126E 

000012A5 

00000F0E 

00000F45 

00000024 

01 

TEST. 02 

CH.TAMM 

P 

00000E06 

OOOOOE4D 

00000DD6 

00000E1D 

00000015 

01 

OBJECT_E 

OH.PTRAC 

P 

00000E4E 

00000EC5 

00000E1E 

00000E95 

00000016 

01 

OBJECT_E 

OH.REMM 

P 

00000EC6 

00000F0D 

00000E96 

00000EDD 

00000017 

01 

OBJECTJE 

OH.REXS 

P 

00000F0E 

00000F45 

OOOOOEDE 

00000F15 

00000024 

01 

TEST. 02 

OH. TAMM 

P 

00000F46 

00000F85 

00000F16 

00000F55 

00000019 

01 

OBJECTJE 

OH . VOMM 

V 

000012A6 

000012E5 

00000F5 6 

00000F95 

00000025 

01 

TEST. 02 

OH . VOMM 

P 

00000FB6 

00000FFD 

00000F96 

00000FDD 

0000001B 

01 

TEST. 01 

OH.PTRAC 

P 

00000FFE 

00001075 

00000FDE 

00001055 

0000001C 

01 

TEST. 01 

OH.REMM 

P 

00001076 

000010BD 

00001056 

0000109D 

0000001D 

01 

TEST. 01 

OH . REXS 

P 

000010BE 

000010F5 

000010 9E 

000010D5 

0000001E 

01 

TEST. 01 

OH. TAMM 

P 

000010F6 

00001135 

000010D6 

00001115 

0 0 0 0 0 0 IF 

01 

TEST. 01 

OH . VOMM 

V 

00001226 

0000126D 

00001116 

0000115D 

00000023 

01 

TEST. 02 

OH . REXS 


Figure 14-1 

J.DSCMP Segment Report 
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14.3.3 TYP Codes 

After compression, J.DSCMP identifies each resource segment with one of the 
following TYP codes: 

• N — Nonmovable segment that remains in the vacate area. J.DSCMP lists the 
reason why the segment was not moved in the NEW BEG column. 


Message 


Means that the segment 


A DEFAULT IMAGE 
A FAST FILE 
A MDT FILE 
A RESTORING FILE 
FAIL CREATE TEMP 
FAIL TO OPEN FILE 
INVALID RD ADDRESS RD 
MED. MAN. SEGMENT 

NOT PERM. FILE 
START SECTOR FILE 
WRONG SEGMENT-DEF 

WRONG TEMP SIZE 


contains a default image 
is a fast file 

has an entry in the MDT 
is being restored 

temporary file couldn’t be created 
cannot be opened by J.DSCMP 
address doesn’t match address in RID 
used by Media Management 
(includes bad sectors) 
is not a permanent file 
was created with a specific start sector 
definition changed since the V list 
was created 

temporary file is not large enough 


• V — V list segment that was successfully moved from the vacate area to the pack 
area. The new segment definition (start and end sectors) is always below the 
bound. 

• P — segment moved in phase two when consolidating segments towards the low 
end of the disk. If sufficient free space is not available in the pack area, P moves 
occur above the bound in the vacate area. 
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14.4 Error Messages 

J.DSCMP displays the following error messages on the terminal: 

FIRST PARAMETER MUST BE VOLUME NAME 
SPECIFIED VOLUME IS NOT MOUNTED 

SYSTEM ADMINISTRATOR ATTRIBUTE IS REQUIRED TO RUN THIS TASK 

TOO MANY ARGUMENTS OR INVALID ARGUMENT SPECIFIED 

UNABLE TO READ VOLUME DESCRIPTOR 

UNABLE TO OBTAIN EXTENDED MEMORY 

UNABLE TO READ SMAP DESCRIPTOR 

UNABLE TO READ SMAP DEALLOCATION FILE DESCRIPTOR 

UNABLE TO READ GENERAL ALLOCATABLE RESOURCE DESCRIPTORS' 
DESCRIPTOR 

UNABLE TO ASSIGN SMAP OR READ ERROR ON SMAP 

The following messages display when an I/O error occurs while correcting a previous 
I/O error. Because the specified resource segment is no longer marked as allocated in 
the SMAP, it is susceptible to allocation to another resource if volume cleanup is not 
performed. 

COMPRESSION TERMINATED DUE TO FATAL WRITE ERROR ON SEGMENT V (DECIMAL) 
OF PATH @ pathname 

FATAL ERROR. J.DSCMP SUSPENDED UNTIL REPAIR AND/OR REBOOT PERFORMED. 

^pathname 

x is the segment where the error occurred 

pathname is the volume, directory, and file where the error occurred 

If this occurs, J.DSCMP remains in suspension and retains exclusive allocation of all 
relevant disk data until the system administrator performs a volume clean-up with 
control switch 7 not set. This corrects the file overlap by deleting the temporary file’s 
resource descriptor without modifying the segment definition. 

Note: If J.DSCMP exits or is deleted, the space used by the permanent file is freed. 
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A.1 Description 

Throughout the MPX-32 Reference Manual, the generic descriptor devmnc indicates 
that a device can be specified. 

Under MPX-32, device addresses are specified using a combination of three levels of 
identification. They are device type, device channel/controller address, and device 
address/subaddress. 

A device can be specified using the generic device type mnemonic only, which results 
in allocation of the first available device of the type requested. Device type 
mnemonics are listed in Table A-l. 

A second method of device specification is achieved by using the generic device type 
mnemonic and specifying the channel/controller address. This results in allocation of 
the first available device of the type requested on the specified channel or controller. 

The third method of device selection requires specification of the device type 
mnemonic, channel/controller, and device address/subaddress. This method allows 
specification of a particular device. 
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Table A-1 

Device Type Mnemonics and Codes 


Device 

Type 

Code 

Device 

Type 

Mnemonic 

Device Description 

00 

CT 

Operator console (not assignable) 

01 

DC 

Any disk unit except memory disk 

02 

DM 

Any moving head or memory disk 

03 

DF 

Any fixed head disk 

04 

MT 

Any magnetic tape unit 

05 

M9 

Any 9-track magnetic tape unit* 

06 

Ml 

Any 7-track magnetic tape unit* 

08 

CR 

Any card reader 

0A 

LP 

Any line printer 

0B 

PT 

Any paper tape reader-punch 

OC 

TY 

Any teletypewriter (other than console) 

0D 

CT 

Operator console (assignable) 

OE 

FL 

Floppy disk 

OF 

NU 

Null device 

10 

CA 

Communications adapter (binary synchronous/asynchronous) 

11 

uo 

Available for user-defined applications 

12 

U1 

Available for user-defined applications 

13 

U2 

Available for user-defined applications 

14 

U3 

Available for user-defined applications 

15 

U4 

Available for user-defined applications 

16 

U5 

Available for user-defined applications 

17 

U6 

Available for user-defined applications 

18 

U7 

Available for user-defined applications 

19 

U8 

Available for user-defined applications 

1A 

U9 

Available for user-defined applications 

IB 

LF 

Line printer/floppy controller (used only with SYSGEN) 

N/A 

ANY 

Any nonfloppy disk except memory disk 


* When both 7- and 9-track magnetic tape units are configured, the designation 
must be 7-track. 
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A.2 Special Device Specifications and Handling 

A.2.1 Magnetic Tape/Floppy Disk 

For magnetic tape and floppy disks, unblocking, density, a reel identifier, and 
multi volume number (magnetic tape only) can be included in the device specification. 


Syntax 

$ ASSIGN Ifc TO DEVsdevmnc [BLOCKED={ Y IN}] 

[DENSITY* {N I PIG 1800 1 1600 16250}] [ID =id] [MULTIVOL =number] 

Ifc is a 1- to 3-character logical file code 

DEV sdevmnc 

devmnc is the device specification of a configured peripheral device (see 
the Description section) 

[BLOCKED={YlN}] 

if Y is specified, medium is blocked. If N is specified, medium is not 
blocked. If not specified the default is blocked. 

[DENSITY* { N I P I G 1 800 1 1 600 1 6250 } ] 

specifies density of high speed XIO tape. If not specified, the default is 
6250 bpi. Values are as follows: 

Value Description 

N or 800 indicates 800 bpi nonreturn to zero inverted (NRZI). 

P or 1600 indicates 1600 bpi phase encoded (PE). 

G or 6250 indicates 6250 bpi group coded recording (GCR). 

This is the default. 

[ID=id] id specifies a 1- to 4-character identifier for the reel. If not specified, the 
default is SCRA (scratch). 

[MU LTIVOLsnumber] 

number is a volume number. If multivolume tape, number must be 
specified. If not specified, the default is not multivolume (0). This option 
is not valid for use with floppy disks. 

When the task that has an assignment to tape is activated, a mount message indicates 
the name of the task and other information on the system console: 

MOUNT reel VOL volume ON devmnc 

TASK taskname , taskno REPLY R, H,A, OR DEVICE: 

jobno 

reel specifies a 1- to 4-character identifier for the reel. If not specified, the 

default is SCRA (Scratch). 
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volume identifies the volume number to mount if multivolume tape 

devmnc is the device mnemonic for the tape unit selected in response to the 
assignment. If a specific channel and subaddress are supplied in the 
assignment, the specific tape drive is selected and named in the message; 
otherwise, a unit is selected by the system and its complete address is 
named in the message. 

jobno identifies the job by job number if the task is part of a batch job 
taskname is the name of the task to which the tape is assigned 
taskno is the task number assigned to the task by the system 
R,H,A, OR DEVICE 

the device listed in the message can be allocated and the task resumed 
(R), a different device can be selected (DEVICE), the task can be aborted 
(A), or the task can be held with the specified device deallocated (H). If 
an R response is given and a high speed XIO tape drive is being used, its 
density can be changed when the software select feature is enabled on the 
tape unit front panel. If specified, it overrides any specification made at 
assignment. Example usage: RN, Rl 6 00, etc. 

Note: Do not insert blanks or commas. 

Response: 

To indicate the drive specified in the mount message is ready and proceed with the 
task, mount the tape on the drive and type R (resume), optionally followed by a 
density specification if the drive is a high speed XIO tape unit. To abort the task, type 
A (abort). To hold the task and deallocate the specified device, type H (hold). The 
task can be resumed by the OPCOM CONTINUE directive; at which time, a tape 
drive is selected by the system and the mount message redisplayed. 

To select a tape drive other than the drive specified in the message, enter the 
mnemonic of the drive to be used. Any of the three levels of device identification can 
be used. The mount message is reissued. Mount the tape and type R if satisfactory, 
or if not satisfactory, abort, override, or hold as described. 

Examples of the three methods of device specification follow: 

Type 1 - Generic Device Class 

$ ASSIGN OUT TO DEV=M9 MUL=1 ID=MVOL 

In this example, the device assigned to logical file code (LFC) OUT is any 9-track 
tape unit on any channel. The multi volume reel number is 1. The reel identifier is 
MVOL and the tape is blocked. 
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Type 2 - Generic Device Class and Channel/Controller 

$ ASSIGN OUT TO DEV=M910 ID=MVOL BLO=N 

In this example, the device assigned to logical file code (LFC) OUT is the first 
available 9 -track tape unit on channel 10. The specification is invalid if a 9-track 
tape unit does not exist on the channel. The reel identifier is MVOL. This is not a 
multivolume tape and is unblocked. 

Type 3 - Specific Device Request 

$ AS SIGN OUT TO DEV=M91001 

In this example, the device assigned to logical file code (LFC) OUT is the 9-track 
tape unit 01 on channel 10. The specification is invalid if unit 01 on channel 10 is 
not a 9-track tape. The tape reel identifier is SCRA. The tape is blocked and is not 
multivolume. 


A.2.2 Temporary Disk Space 

For a temporary disk file the following can be specified: size, blocking, printing or 
punching, and access. 

Syntax 

$ASSIGN Ifc TO TEMP [=(volname)\ [ACCESS=([READ] [WRITE] [MODIFY] [UPDATE] [APPEND])] 
[BLOCKEDs [YIN]] [PRINTI PUNCH] [SIZEsWocfa] 

Ifc is a 1- to 3-character logical file code 

TEMP[=(volname)] 

volname is the 1- to 16-character volume name where temporary space is 
allocated. If not specified, the default is the current working volume or 
any public volume. 

[ACCESS=([READ] [WRITE] [MODIFY] [UPDATE] [APPEND])] 

specifies the types of access for the file. If not specified, the default is the 
access specified at file creation. 

[BLOCKED={ YIN}] 

if Y is specified, the file is blocked. If N is specified, the file is 
unblocked. If not specified, the default is blocked. 

[PRINT I PUNCH] 

indicates the file is to be printed (PRINT) or punched (PUNCH) after 
deassignment 

[SlZE=bloclcs] 

blocks is the number of 192-word blocks required. If not specified, the 
default is 16 blocks. 
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Examples 

In the following example, the device assigned to logical file code (LFC) OUT is the 
current working volume or any public volume and the file prints to the SLO device 
after deassignment. 

AS OUT TO TEM PRI 

The following example designates the system volume as the device for the temporary 
blocked file. 

AS OUT TO TEMP=( SYSTEM) BLO=Y 



A.3 GPMC Devices 

GPMC/GPDC device specifications follow the general structure just described. The 
terminal at subaddress 04 on GPMC 01 whose channel address is 20 would be 
identified as follows: 

$AS DEV TO DEV=TY2004 


A.4 Null Device 

A special device type, NU, is available for null device specifications. Files accessed 
using this device type generate an end-of-file (EOF) when a read is attempted and 
normal completion when a write is attempted. 

A.5 System Console 

Logical file codes are assigned to the system console by using the device type CT. 

A.6 Special System Files 

There are four special mnemonics provided for access to special system files: SLO, 
SBO, SGO and SYC. These are assigned with the $ ASSIGN statement, as in: 

$ ASSIGN OUT TO SLO 

For nonbatch tasks, SLO and SBO files are allocated dynamically by the system and 
used to disk buffer output to a device selected automatically. For batch tasks, use of 
SLO and SBO files is identical, except that automatic selection of a device can be 
overridden by assigning a specific file or device. 
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A.7 Samples 

A description of device selection possibilities is constructed as follows: 

Disk 


DC 

DM 

DM08 

DM0801 

DM0002 

DF 

DF04 

DF0401 

Tape 

MT 

M9 

M910 

M91002 

Card Equipment 

CR 

CR78 

CR7800 

Line Printer 

LP 

LP7A 

LP7A00 

LP7EA0 


Any disk except memory disk 
Any moving head or memory disk 
Any moving head disk on channel 08 
Moving head disk 0 1 on channel 0 8 
Memory disk 02 on channel 00 
Any fixed head disk 
Any fixed head disk on channel 0 4 
Fixed head disk 01 on channel 0 4 


Any magnetic tape 

Any 9-track magnetic tape 

Any 9-track magnetic tape on channel 10 

9-track magnetic tape 0 2 on channel 1 0 


Any card reader 

Any card reader on channel 7 8 

Card reader 0 0 on channel 7 8 


Any line printer 
Any line printer on channel 7 A 
Line printer 00 on channel 7 A 
Serial printer A0 on ACM channel 7E 
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B.1 Macro Name Listing 


Macro 

Description 

SVC 

Module, 

E.P. 

Volume I 

Ref.Manual 

Section 

M.ACTV 

Activate Task 

1,X’52’ 

H.REXS.15 

6.2 

M_ACTV 

Activate Task 

1,X’52’ 

H.REXS.15 

7.2 

M.ADRS 

Memory Address 
Inquiry 

1,X’44’ 

H.REXS.3 

6.2 

M_ADRS 

Memory Address 
Inquiry 

1,X’44’ 

H.REXS.3 

7.2 

M_ADVANCE 

Advance Record 

1,X’33’ 

H.IOCS.7 

7.2 


Advance File 

1,X’34’ 

H.IOCS.8 

7.2 

M.ALOC 

Allocate File or 
Peripheral Device 

1,X’40’ 

H.MONS.21 

6.4 

M.ANYW 

Wait for Any No- wait 
Operation Complete, 
Message Interrupt, 
or Break Interrupt 

1,X’7C’ 

H.REXS.37 

6.2 

M_ ANY WAIT 

Wait for Any No- wait 
Operation Complete, 
Message Interrupt, 
or Break Interrupt 

1,X’7C’ 

H.REXS,37 

7.2 

M_ASSIGN 

Assign and Allocate 
Resource 

2,X’52’ 

H.REXS.21 

7.2 

M.ASSN 

Assign and Allocate 
Resource 

2,X’52’ 

H.REXS.21 

6.2 

M.ASYNCH 

Set Asynchronous 
Task Interrupt 

1,X’1C’ 

H.REXS,68 

6.2 

M_ASYNCH 

Set Asynchronous 
Task Interrupt 

1,X’1C’ 

HJREXS.68 

7.2 

M_AWAITACTION 

End Action Wait 

1,X’1D’ 

H£XEC,40 

7.2 

M.BACK 

Backspace Record 

1,X’35’ 

H.IOCS,9 

6.2 


Backspace File 

1,X’36’ 

H.IOCS.19 

6.2 

M.BACKSPACE 

Backspace Record 

1,X’35’ 

H.IOCS.9 

7.2 


Backspace File 

1,X’36’ 

H.IOCS,I9 

7.2 

M.BATCH 

Batch Job Entry 

2,X , 55’ 

H.REXS.27 

6.2 

m_batch 

Batch Job Entry 

2,X’55’ 

H.REXS,27 

7.2 
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Macro 

Description 

SVC 

Module, 

E.P. 

Ref.Manual 

Section 

M.BBTIM 

Acquire Current 
Date/Time in Byte 
Binary Format 

2,X’50’ 

H.REXS.74 

6.2 

M_BBTIM 

Acquire Current 
Date/Time in Byte 
Binary Format 

2,X’50’ 

H.REXS.74 

7.2 

M.BORT 

Abort Specified Task 

1,X’56’ 

H.REXS.19 

6.2 


Abort Self 

1,X’57’ 

H.REXS.20 

6.2 


Abort With Extended 
Message 

1,X’62’ 

H.REXS.28 

6.2 

M_BORT 

Abort Specified 
Task 

l.X’56’ 

H.REXS.19 

7.2 


Abort Self 

1,X’57’ 

H.REXS.20 

7.2 


Abort With Extended 
Message 

l.X’62’ 

H.REXS.28 

7.2 

M.BRK 

Break/Task 
Interrupt Link/Unlink 

1,X’6E’ 

H.REXS.46 

6.2 

M_BRK 

Break/Task 
Interrupt Link/Unlink 

1,X’6E’ 

H.REXS.46 

7.2 

M.BRKXIT 

Exit From Task 
Interrupt Level 

1,X’70’ 

H.REXS.48 

6.2 

MJBRKXIT 

Exit From Task 
Interrupt Level 

N/A 

N/A 

7.2 

M.BTIM 

Acquire Current 
Date/Time in 
Binary Format 

2,X’50’ 

H.REXS.74 

6.2 

m_btim 

Acquire Current 
Date/Time in 
Binary Format 

2X50’ 

H.REXS.74 

7.2 

M.CDJS 

Submit Job from 
Disc File 

i,x’6r 

H.MONS.27 

6.4 

M_CHANPROGFCB 

Execute Channel 
Program File 
Control Block 

N/A 

N/A 

7.2 

M.CLOSER 

Close Resource 

2,X’43’ 

H.REMM.22 

6.2 

M_CLOSER 

Close Resource 

2,X’43’ 

H.REMM.22 

7.2 

M.CLSE 

Close File 

1,X’39’ 

H.IOCS.23 

6.2 

M_CLSE 

Close File 

1,X’39’ 

H.IOCS.23 

7.2 
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Macro 

Description 

SVC 

Module, 

E.P. 

Volume I 

Ref.Manual 

Section 

M.CMD 

Get Command Line 

2,X’61’ 

H.REXS.88 

6.2 

M_CMD 

Get Command Line 

2,X’61’ 

H.REXS.88 

7.2 

M.CONABB 

Convert ASCII 
Date/Time to 
Byte Binary Format 

2,X’51’ 

HJREXS.75 

6.2 

M_CONABB 

Convert ASCII 
Date/Time to 
Byte Binary Format 

2,X’51’ 

H.REXS.75 

7.2 

M.CONADB 

Convert ASCII 
Decimal to Binary 

1,X’28’ 

H.TSM.7 

6.2 

M_CONADB 

Convert ASCII 
Decimal to Binary 

1,X’28’ 

H.TSM.7 

7.2 

M.CONAHB 

Convert ASCII 
Hex to Binary 

1,X’29’ 

H.TSM.8 

6.2 

M_CONAHB 

Convert ASCII 
Hex to Binary 

1,X’29’ 

H.TSM.8 

7.2 

M.CONASB 

Convert ASCII 
Date/Time to 
Standard Binary 

2,X’51’ 

H.REXS,75 

6.2 

M_CONASB 

Convert ASCII 
Date/Time to 
Standard Binary 

2,X’51’ 

H.REXS.75 

7.2 

M.CONBAD 

Convert Binary to 
ASCII Decimal 

1,X’2A’ 

H.TSM,9 

6.2 

M_CONBAD 

Convert Binary to 
ASCII Decimal 

1,X’2A’ 

H.TSM.9 

7.2 

M.CONBAF 

Convert Binary 
Date/Time to 
ASCII Format 

2,X’51’ 

H.REXS,75 

6.2 

M_CONBAF 

Convert Binary 
Date/Time to 
ASCII Format 

2,X’51’ 

H.REXS.75 

7.2 

M.CONBAH 

Convert Binary to 
ASCII Hex 

1,X’2B’ 

H.TSM.10 

6.2 

M.CONBAH 

Convert Binary to 
ASCII Hex 

1,X’2B’ 

H.TSM.10 

7.2 

M.CONBBA 

Convert Byte Binary 
Date/Time to ASCII 

2,X’51’ 

H.REXS.75 

6.2 
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Macro 

Description 

SVC 

E.P. 

Section 

M.CONBBA 

Convert Byte Binary 
Date/Time to ASCII 

2,X’51’ 

H.REXS.75 

7.2 

M.CONBBY 

Convert Binary 
Date/Time to Byte Binary 

2,X’5r 

H.REXS.75 

6.2 

M_CONBBY 

Convert Binary 
Date/Time to Byte Binary 

2,X’5r 

H.REXS.75 

7.2 

M.CONBYB 

Convert Byte Binary 
Date/Time to Binary 

2,X’51’ 

H.REXS.75 

6.2 

M.CONBYB 

Convert Byte Binary 
Date/Time to Binary 

2,X’51’ 

H.REXS.75 

7.2 

M.CONN 

Connect Task to 
Interrupt 

1,X’4B’ 

H.REXS.10 

6.2 

M_CONN 

Connect Task to 
Interrupt 

1,X’4B’ 

H.REXS.10 

7.2 

M_CONSTRUCTPATH 

Reconstruct 

Pathname 

2,X’2F’ 

H.VOMM.16 

7.2 

M_CONVERTTIME 

Convert Time 

2,X’5r 

H.REXS.75 

7.2 

M.CPERM 

Create Permanent 
File 

2,X’20’ 

H.VOMM,l 

6.2 

M.CREATE 

Create Permanent 
File 

1,X’75’ 

H.FISE.12 

6.4 

M_CREATEFCB 

Create File Control 
Block 

N/A 

N/A 

7.2 

M_CREATEP 

Create Permanent File 

2,X’20’ 

H.VOMM.1 

7.2 

M_CREATET 

Create Temporary File 

2,X’21’ 

H.VOMM.2 

7.2 

M.CTIM 

Convert System 
Date/Time Format 

2,X’51’ 

H.REXS.75 

6.2 

M_CTIM 

Convert System 
Date/Time Format 

2,X’51’ 

H.REXS.75 

7.2 

M.CWAT 

System Console Wait 

1,X’3D’ 

H.IOCS.26 

6.2 

M_CWAT 

System Console Wait 

1,X’3D’ 

H.IOCS.26 

7.2 

M.DALC 

Deallocate File 
or Peripheral Device 

i,x’4r 

H.MONS.22 

6.4 

M.DASN 

Deassign and 
Deallocate Resource 

2,X’53’ 

H.REXS.22 

6.2 
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Macro 

Description 

SVC 

Module, 

E.P. 

Ref.Manual 

Section 

M.DATE 

Date and Time 
Inquiry 

1,X’15’ 

H.REXS.70 

6.2 

M_DATE 

Date and Time 
Inquiry 

1,X’15’ 

H.REXS.70 

7.2 

M.DEASSIGN 

Deassign and 
Deallocate Resource 

2,X’53’ 

H.REXS.22 

7.2 

M.DEBUG 

Load and Execute 
Interactive Debugger 

1,X’63’ 

H.REXS.29 

6.2 

M_DEBUG 

Load and Execute 
Interactive Debugger 

l.X’63’ 

H.REXS.29 

7.2 

M.DEFT 

Change Defaults 

2,X’27’ 

H.VOMM.8 

6.2 

M_DEFT 

Change Defaults 

2,X’27’ 

H.VOMM.8 

7.2 

M. DELETE 

Delete Permanent 
File or Non-S YSGEN 
Memory Partition 

1,X’77’ 

H.FISE.14 

6.4 

M_DELETER 

Delete Resource 

2,X’24’ 

H.VOMM.5 

7.2 

M.DELR 

Delete Resource 

2,X’24’ 

H.VOMM.5 

6.2 

M.DELTSK 

Delete Task 

1,X’5A’ 

H.REXS.31 

6.2 

M_DELTSK 

Delete Task 

1,X’5A’ 

H.REXS.31 

7.2 

M.DEVID 

Get Device Mnemonic 
or Type Code 

1,X’14’ 

H.REXS.71 

6.2 

M_DEVID 

Get Device Mnemonic 
or Type Code 

1,X’14’ 

H.REXS.71 

7.2 

M.DFCB 

Create File Control 
Block 

N/A 

N/A 

5.9.1 

M.DIR 

Create Directory 

2,X’23’ 

H.VOMM.4 

6.2 

M_D1R 

Create Directory 

2,X’23’ 

H.VOMM.4 

7.2 

M.DISCON 

Disconnect Task 
from Interrupt 

1,X’5D’ 

H.REXS.38 

6.2 

M_DISCON 

Disconnect Task 
from Interrupt 

1,X’5D’ 

H.REXS.38 

7.2 

M_DISMOUNT 

Dismount Volume 

2,X’4A’ 

H.REMM.19 

7.2 

M.DLTT 

Delete Timer Entry 

1,X’47’ 

H.REXS.6 

6.2 

M_DLTT 

Delete Timer Entry 

1,X’47’ 

H.REXS.6 

7.2 

M.DMOUNT 

Dismount Volume 

2,X’4A’ 

H.REMM.19 

6.2 
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Module, 
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Section 

M.DSMI 

Disable Message 
Task Interrupt 

1,X’2E’ 

H.REXS.57 

6.2 

M_DSMI 

Disable Message 
Task Interrupt 

I,X’2E’ 

H.REXS.57 

7.2 

M.DSUB 

Disable User 
Break Interrupt 

1X12’ 

H.REXS.73 

6.2 

M.DSUB 

Disable User 
Break Interrupt 

1,X’12’ 

H.REXS.73 

7.2 

M.DUMP 

Memory Dump Request 

1*X’4F 

KLREXS.12 

6.2 

M_DUMP 

Memory Dump Request 

1,X’4F 

H.REXS,12 

7.2 

M.EAWAIT 

End Action Wait 

1,X’1D’ 

H.EXEC.40 

6.2 

M.ENMI 

Enable Message 
Task Interrupt 

1,X’2F’ 

H.REXS,58 

6.2 

m_enmi 

Enable Message 
Task Interrupt 

1,X’2F 

H.REXS.58 

7.2 

M.ENUB 

Enable User 
Break Interrupt 

1,X’13’ 

H.REXS.72 

6.2 

M_ENUB 

Enable User 
Break Interrupt 

1,X’13’ 

H.REXS.72 

7.2 

M.ENVRMT 

Get Task 
Environment 

2,X’5E’ 

H.REXS.85 

6.2 

m_envrmt 

Get Task 
Environment 

2,X’5E’ 

H.REXS.85 

7.2 

M.EXCL 

Free Shared Memory 

l.X’79’ 

H.ALOC,14 

6.4 

M.EXCLUDE 

Exclude Memory 
Partition 

2X41’ 

H.REMM,14 

6.2 

M_EXCLUDE 

Exclude Shared 
Image 

2,X , 41’ 

H.REMM.14 

7.2 

M.EXIT 

Terminate Task 
Execution 

1,X’55’ 

H.REXS.18 

6.2 

M_EXIT 

Terminate Task 
Execution 

1,X’55’ 

H.REXS.18 

7.2 

M.EXTD 

Extend File 

2,X’25’ 

H.VOMM.6 

6.2 

M_EXTENDFILE 

Extend File 

2,X’25’ 

H.VOMM.6 

7.2 

M_EXTSTS 

Exit With Status 

2,X’5F’ 

H.REXS.86 

7.2 

M.FADD 

Permanent File 
Address Inquiry 

1,X’43’ 

H.MONS.2 

6.4 
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SVC 

E.P. 

Section 

M.FD 

Free Dynamic Extended 
Indexed Data Space 

1,X’6A’ 

H.REMM.9 

6.2 

M.FE 

Free Dynamic Task 
Execution Space 

1,X’68’ 

H.REMM.11 

6.2 

M.FELE 

Open File 

1,X’30’ 

H.IOCS.1 

6.4 

M_FREEMEMBYTES 

Free Memory in Byte 
Increments 

2,X’4C’ 

H.REMM.29 

7.2 

M.FSLR 

Release 

Synchronization File Lock 

l,X’24’ 

H.FISE.25 

6.4 

M.FSLS 

Set Synchronization 
File Lock 

1,X’23’ 

H.FISE.24 

6.4 

M.FWRD 

Advance Record 

1,X’33’ 

H.IOCS.7 

6.2 


Advance File 

1,X’34’ 

H.IOCS.8 

6.2 

M.FXLR 

Release Exclusive 
File Lock 

1,X’22’ 

H.FISE.23 

6.4 

M.FXLS 

Set Exclusive 
File Lock 

1,X’21’ 

H.FISE.22 

6.4 

M.GADRL 

Get Address Limits 

l.X’65’ 

H.REXS.41 

6.2 

M.GADRL2 

Get Address Limits 

2,X’7B’ 

H.REXS.80 

6.2 

M.GD 

Get Dynamic 
Extended Data Space 

1,X’69’ 

H.REMM.8 

6.2 

M.GDD 

Get Dynamic 
Extended Discontiguous 
Data Space 

2,X’7C’ 

H.MEMM.9 

6.2 

M.GE 

Get Dynamic Task 
Execution Space 

1,X’67’ 

H.REMM.10 

6.2 

M_GETCTX 

Get User Context 

2,X’70’ 

H.EXEC.41 

7.2 

M.GETDEF 

Get Terminal Function 
Definition 

2,X’7A’ 

H.TSM.15 

6.2 

M_GETDEF 

Get Terminal Function 
Definition 

2,X’7A’ 

H.TSM.15 

7.2 

M_GETME MBYTES 

Get Memory in Byte 
Increments 

2,X’4B’ 

H.REMM.28 

7.2 

M_GETTIME 

Get Cunrent Date 
and Time 

2,X’50’ 

H.REXS/74 

7.2 

M.GMSGP 

Get Message 

1,X’7A’ 

H.REXS.35 

6.2 


Parameters 
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Macro 

Description 

SVC 

Module, 

E.P. 

Volume I 

ReLManual 

Section 

M_GMSGP 

Get Message 
Parameters 

1,X’7A’ 

H.REXS.35 

7.2 

M.GRUNP 

Get Run Parameters 

1,X’7B’ 

H.REXS.36 

6.2 

M_GRUNP 

Get Run Parameters 

1,X’7B’ 

H.REXS.36 

7.2 

M.GTIM 

Acquire System 
Date/Time in 
Any Format 

2,X’50’ 

H.REXS/74 

6.2 

M_GTIM 

Acquire System 
Date/Time in 
Any Format 

2,X’50’ 

H.REXS.74 

7.2 

M.GTSAD 

Get TSA Start Address 

2,X’7D’ 

H.REXS.91 

6.2 

M_GTSAD 

Get TSA Start Address 

2,X’7D’ 

H.REXS.91 

7.2 

M.HOLD 

Program Hold 
Request 

1,X’58’ 

H.REXS.25 

6.2 

M_HOLD 

Program Hold 
Request 


H.REXS,25 

7.2 

M.ID 

Get Task Number 

1,X’64’ 

H.REXS.32 

6.2 

M_ID 

Get Task Number 

l.X’64’ 

H.REXS.32 

7.2 

M.INCL 

Get Shared Memory 

1,X’72’ 

H.ALOC.13 

6.4 

M.INCLUDE 

Include Memory 
Partition 

2,X’40’ 

H.REMM.12 

6.2 

M_INCLUDE 

Include Shared 
Image 

2,X , 40’ 

H.REMM.12 

7.2 

MJNQUIRER 

Resource Inquiry 

2,X’48’ 

H.REMM.27 

7.2 

M.INQUIRY 

Resource Inquiry 

2,X’48’ 

H.REMM.27 

6.2 

M.INT 

Activate Task 
Interrupt 

1,X’6F’ 

H.REXS.47 

6.2 

MJNT 

Activate Task 
Interrupt 

1,X’6F’ 

H.REXS.47 

7.2 

M.IPUBS 

Set IPU Bias 

2,X’5B’ 

H.REXS.82 

6.2 

M_IPUBS 

Set IPU Bias 

2,X’5B’ 

H.REXS.82 

7.2 

M_LIMITS 

Get Base Mode 
Task Address Limits 

2,X’5D’ 

H.REXS.84 

7.2 

M.LOC 

Read Descriptor 

2,X’2C’ 

H.VOMM.13 

6.2 

M.LOCK 

Set Exclusive 
Resource Lock 

2,X’44’ 

H.REMM.23 

6.2 
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Volume I 


Macro 

Description 

SVC 

Module, 

E.P. 

Ref.Manual 

Section 

M_LOCK 

Set Exclusive 
Resource Lock 

2,X’44’ 

H.REMM.23 

7.2 

M.LOG 

Permanent File Log 

1,X’73’ 

H.MONS.33 

6.4 

M.LOGR 

Log Resource 
or Directory 

2,X’29’ 

H.VOMM.IO 

6.2 

M_LOGR 

Log Resource 
or Directory 

2,X’29’ 

H.VOMM.10 

7.2 

M.MEM 

Create Memory 
Partition 

2,X’22’ 

H.VOMM.3 

6.2 

M_MEM 

Create Memory 
Partition 

2,X’22’ 

H.VOMM.3 

7.2 

M.MEMB 

Get Memory in 
Byte Increments 

2,X’4B’ 

H.REMM.28 

6.2 

M.MEMFRE 

Free Memory in 
Byte Increments 

2,X’4C’ 

H.REMM,29 

6.2 

M.MOD 

Modify Descriptor 

2,X’2A’ 

H.VOMM.11 

6.2 

M_MOD 

Modify Descriptor 

2,X’2A’ 

H.VOMM.11 

7.2 

M.MODU 

Modify Descriptor 
User Area 

2,X’31’ 

H.VOMM.26 

6.2 

M_MODU 

Modify Descriptor 
User Area 

2,X’31’ 

H.VOMM.26 

7.2 

M.MOUNT 

Mount Volume 

2,X’49’ 

H.REMM.17 

6.2 

M_MOUNT 

Mount Volume 

2,X’49’ 

H.REMM.17 

7.2 

M.MOVE 

Move Data to User 
Address 

2,X’62’ 

H.REXS.89 

6.2 

M_MOVE 

Move Data to User 
Address 

2,X’6T 

H.REXS.89 

7.2 

M.MYID 

Get Task Number 

1,X’64’ 

H.REXS,32 

6.2 

M_MYID 

Get Task Number 

1,X’64’ 

H.REXS.32 

7.2 

M.NEWRRS 

Reformat RRS Entry 

2,X’54’ 

H.REXS.76 

6.2 

M.OLAY 

Load Overlay Segment 

1,X’50’ 

H.REXS.13 

6.2 


Load and Execute 
Overlay 

i,x’5r 

H.REXS.14 

6.2 

M.OPENR 

Open Resource 

2,X’42’ 

H.REMM,21 

6.2 

M_OPENR 

Open Resource 

2,X’42’ 

H.REMM.21 

7.2 

M_OPTIONDWORD 

Task Option 
Doubleword Inquiry 

2,X’C0’ 

H.REXS.95 

7.2 
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Macro 

Description 

SVC 

Module, 

E.P. 

Volume I 

Ref.Manual 

Section 

M_OPTIONWORD 

Task Option Word 
Inquiry 

1,X’4C’ 

H.REXS.24 

7.2 

M.OSREAD 

Physical Memory 
Read 

2,X’7E’ 

H.REXS.93 

6.2 

M_OSREAD 

Physical Memory 
Read 

2,X’7E’ 

H.REXS.93 

7.2 

M.OSWRIT 

Physical Memory 
Write 

2,X’AF’ 

H.REXS.94 

6.2 

M_OSWRIT 

Physical Memory 
Write 

2,X’AF’ 

H.REXS.94 

7.2 

M.PDEV 

Physical Device 
Inquiry 

1,X’42’ 

H.MONS.1 

6.4 

M.PERM 

Change Temporary 
File to Permanent 

1,X’76’ 

H.FISE.13 

6.4 

M.PGOD 

Task Option 
Doubleword Inquiry 

2,X’C0’ 

H.REXS,95 

6.2 

M.PGOW 

Task Option Word 
Inquiry 

1,X’4C’ 

H.REXS.24 

6.2 

M.PNAM 

Reconstruct 

Pathname 

2,X , 2F 

H.VOMM.16 

6.2 

M.PNAMB 

Convert Pathname 
to Pathname Block 

2,X’2E’ 

H.VOMM.15 

6.2 

M_PNAMB 

Convert Pathname 
to Pathname Block 

2,X’2E’ 

H.VOMM.15 

7.2 

M.PRIL 

Change Priority Level 

1,X’4A’ 

H.REXS.9 

6.2 

M_PRIL 

Change Priority Level 

1,X’4A’ 

H.REXS.9 

7.2 

M.PRIV 

Reinstate Privilege 
Mode to Privilege Task 

2,X’57’ 

H.REXS.78 

6.2 

M_PRIVMODE 

Reinstate Privilege 
Mode to Privilege Task 

2,X’57’ 

H.REXS.78 

7.2 

M.PTSK 

Parameter Task 
Activation 

1,X’5F’ 

H.REXS.40 

6.2 

MJPTSK 

Parameter Task 
Activation 

1,X’5F’ 

H.REXS.40 

7.2 

M_PUTCTX 

Put User Context 

2,X’7r 

H.EXEC.42 

7.2 
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Macro 
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SVC 

Module, 

E.P. 

Volume I 
Ref. Manual 
Section 

M.QATIM 

Acquire Current 
Date/Time in 
ASCII Format 

2,X’50’ 

H.REXS.74 

6.2 

M_QATIM 

Acquire Current 
Date/Time in 
ASCII Format 

2,X’50’ 

H.REXS.74 

7.2 

M.RADDR 

Get Real Physical 
Address 

1,X’0E’ 

H.REXS.90 

6.2 

m_raddr 

Get Real Physical 
Address 

1,X’0E’ 

H.REXS,90 

7.2 

M.RCVR 

Receive Message 
Link Address 

1,X’6B’ 

H.REXS.43 

6.2 

M_RCVR 

Receive Message 
Link Address 

1,X’6B’ 

H.REXS.43 

7.2 

M.READ 

Read Record 

1,X’31’ 

H.IOCS.3 

6.2 

M_READ 

Read Record 

1,X’31’ 

H.IOCS.3 

7.2 

M_READD 

Read Descriptor 

2,X’2C’ 

H.VOMM.13 

7.2 

M.RELP 

Release Dual- 
ported Disc/Set Dual- 
channel ACM Mode 

1,X’27’ 

H.IOCS.27 

6.2 

M_RELP 

Release Dual- 
ported Disc/Set Dual- 
channel ACM Mode 

1,X’27’ 

H.IOCS.27 

7.2 

M.RENAM 

Rename File 

2,X’2D’ 

H.VOMM.14 

6.2 

M_RENAME 

Rename File 

2,X’2D’ 

H.VOMM.14 

7.2 

M.REPLAC 

Replace Permanent 
File 

2,X’30’ 

H.VOMM.23 

6.2 

MJREPLACE 

Replace Permanent 
File 

2,X’30’ 

H.VOMM.23 

7.2 

M.RESP 

Reserve Dual- 
ported Disc/Set 
Single-channel 
ACM Mode 

1,X’26’ 

H.IOCS.24 

6.2 

M_RESP 

Reserve Dual- 
ported Disc/Set 
Single-channel 
ACM Mode 

1,X’26’ 

H.IOCS.24 

7.2 

M_REWIND 

Rewind File 

1,X’37’ 

H.IOCS.2 

7.2 

M.REWRIT 

Rewrite Descriptor 

2,X’2B’ 

H.VOMM,12 

6.2 
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Macro 
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SVC 

Module, 

E.P. 

Volume I 

Ref.Manual 

Section 

M_REWRIT 

Rewrite Descriptor 

2,X’2B’ 

H.VOMM.12 

7.2 

M.REWRTU 

Rewrite Descriptor 
User Area 

2,X’32’ 

H.VOMM.27 

6.2 

M_REWRTU 

Rewrite Descriptor 
User Area 

2,X’32’ 

H.VOMM.27 

7.2 

M.ROPL 

Reset Option Lower 

2,X’78’ 

H.TSM,14 

6.2 

M_ROPL 

Reset Option Lower 

2,X’78’ 

H.TSM.14 

7.2 

M.RRES 

Release Channel 
Reservation 

1,X’3B’ 

H.IOCS.13 

6.2 

M_RRES 

Release Channel 
Reservation 

1,X’3B* 

H.IOCS.13 

7.2 

M.RSML 

Resourcemark Lock 

1,X’19’ 

H.REXS.62 

6.2 

M_RSML 

Resourcemark Lock 

1,X’19’ 

H.REXS.62 

7.2 

M.RSMU 

Resourcemark Unlock 

1,X’1A’ 

H.REXS.63 

6.2 

M_RSMU 

Resourcemark Unlock 

l.X’lA’ 

H.REXS.63 

7.2 

M.RSRV 

Reserve Channel 

1,X’3A’ 

H.IOCS.12 

6.2 

M_RSRV 

Reserve Channel 

1,X’3A’ 

H.iocs,i2 

7.2 

M.RWND 

Rewind File 

1,X’37’ 

H.IOCS.2 

6.2 

M_SETERA 

Set Exception 
Return Address 

2,X’79’ 

H.REXS.81 

7.2 

M_SETEXA 

Set Exception 
Handler 

2,X’5C’ 

H.REXS.83 

7.2 

M.SETS 

Set User Status Word 

1,X’48’ 

H.REXS.7 

6.2 

M_SETS 

Set User Status Word 

1,X’48’ 

H.REXS.7 

7.2 

M.SETSYNC 

Set Synchronous 
Resource Lock 

2,X’46’ 

H.REMM.25 

6.2 

M.SETS YNC 

Set Synchronous 
Resource Lock 

2,X’46’ 

H.REMM.25 

7.2 

M.SETT 

Create Timer Entry 

1,X’45’ 

H.REXS.4 

6.2 

M.SETT 

Create Timer Entry 

1,X’45’ 

H.REXS.4 

7.2 

M.SHARE 

Share Memory with 
Another Task 

1,X’71’ 

H.ALOC.12 

6.4 

M.SMSGR 

Send Message to 
Specified Task 

1,X’6C’ 

H.REXS.44 

6.2 

M.SMSGR 

Send Message to 

1,X’6C’ 

H.REXS.44 

7.2 


Specified Task 
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Macro 

Description 

SVC 

Module, 

E.P. 

Ref.Manual 

Section 

M.SMULK 

Unlock and Dequeue 
Shared Memory 

1,X’1F’ 

H.ALOC.19 

6.4 

M.SOPL 

Set Option Lower 

2,X’77’ 

H.TSM.13 

6.2 

M_SOPL 

Set Option Lower 

2,X’77’ 

H.TSM.13 

7.2 

M.SRUNR 

Send Run Request to 
Specified Task 

1,X’6D’ 

H.REXS.45 

6.2 

M_SRUNR 

Send Run Request to 
Specified Task 

1,X’6D’ 

H.REXS,45 

7.2 

M.SUAR 

Set User Abort 
Receiver Address 

1,X’60’ 

H.REXS.26 

6.2 

M_SUAR 

Set User Abort 
Receiver Address 

1,X’60’ 

H.REXS.26 

7.2 

M.SUME 

Resume Task 
Execution 

1,X’53’ 

H.REXS.16 

6.2 

M_SUME 

Resume Task 
Execution 

1,X’53’ 

H.REXS.16 

7.2 

M.SURE 

Suspend/Resume 

5,X’00’ 

N/A 

6.2 

M_SURE 

Suspend/Resume 

5,X’00’ 

N/A 

7.2 

M.SUSP 

Suspend Task 
Execution 

1,X’54’ 

H.REXS.17 

6.2 

M_SUSP 

Suspend Task 
Execution 

1,X’54’ 

H.REXS.17 

7.2 

M.SYNCH 

Set Synchronous 
Task Interrupt 

1,X’1B’ 

H.REXS,67 

6.2 

M_SYNCH 

Set Synchronous 
Task Interrupt 

1,X’1B’ 

H.REXS.67 

7.2 

M.TBRKON 

Trap On-line User’s 
Task 

1,X’5C’ 

H.TSM.6 

6.2 

M_TBRKON 

Trap On-line User’s 
Task 

1,X’5C’ 

H.TSM.6 

7.2 

M.TDAY 

Time-of-Day Inquiry 

1,X’4E’ 

H.REXS.11 

6.2 

M_TDAY 

Time-of-Day Inquiry 

1,X’4E’ 

H.REXS.11 

7.2 

M.TEMP 

Create Temporary 
File 

2,X’21’ 

H.VOMM.2 

6.2 
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SVC 

Module, 

E.P. 

Volume I 

Ref.Manual 

Section 

M.TEMPER 

Change Temporary 
File to Permanent File 

2,X’28’ 

H.VOMM.9 

6.2 

M_TEMPFELETOPERM 

Change Temporary 
File to Permanent File 

2,X’28’ 

H.VOMM.9 

7.2 

M.TRNC 

Truncate File 

2,X’26’ 

H.VOMM.7 

6.2 

M_TRUNCATE 

Truncate File 

2,X’26’ 

H.VOMM.7 

7.2 

M.TSCAN 

Scan Terminal Input 
Buffer 

1,X’5B’ 

H.TSM.2 

6.2 

M_TSCAN 

Scan Terminal Input 
Buffer 

1,X’5B’ 

H.TSM.2 

7.2 

M.TSMPC 

TSM Procedure 
Call 

2,X’AE’ 

H.TSM.17 

6.2 

M_TSMPC 

TSM Procedure 
Call 

2,X’AE’ 

H.TSM.17 

7.2 

M.TSTE 

Arithmetic 
Exception Inquiry 

1,X’4D’ 

H.REXS.23 

6.2 

M_TSTE 

Arithmetic 
Exception Inquiry 

1,X’4D’ 

H.REXS.23 

7.2 

M.TSTS 

Test User Status 
Word 

1,X’49’ 

H.REXS.8 

6.2 

M_TSTS 

Test User Status 
Word 

1,X’49’ 

H.REXS.8 

7.2 

M.TSTT 

Test Timer Entry 

1,X’46’ 

H.REXS.5 

6.2 

M_TSTT 

Test Timer Entry 

1,X’46’ 

H.REXS.5 

7.2 

M.TURNON 

Activate Program at 
Given Time of Day 

1,X’1E’ 

H.REXS.66 

6.2 

M_TURNON 

Activate Program at 
Given Time of Day 

1,X’1E’ 

H.REXS.66 

7.2 

M.TYPE 

System Console Type 

1,X’3F’ 

H.IOCS.14 

6.2 

M_TYPE 

System Console Type 

1,X’3F’ 

H.IOCS.14 

7.2 

M.UNLOCK 

Release Exclusive 
Resource Lock 

2,X’45’ 

H.REMM.24 

6.2 

M_UNLOCK 

Release Exclusive 

2,X’45’ 

H.REMM.24 

7.2 


Resource Lock 
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Macro 

MJJNPRIVMODE 

M.UNSYNC 

M_UNSYNC 

M.UPRIV 

M.UPSP 

M_UPSP 

M.USER 

M.VADDR 

M_VADDR 

M.WAIT 

M_WAIT 

M.WEOF 

M.WRIT 

M_ WRITE 

M_WRITEEOF 

M.XBRKR 

M_XBRKR 

M.XIEA 

M_XIEA 

M.XMEA 

M_XMEA 


MPX-32 Reference 


Description 

SVC 

Module, 

E.P. 

Volume I 

Ref.Manual 

Section 

Change Task to 
Unprivileged Mode 

2,X’58’ 

H.REXS.79 

7.2 

Release Synchronous 
Resource Lock 

2,X’47’ 

H.REMM.26 

6.2 

Release Synchronous 
Resource Lock 

2,X'A1' 

H.REMM.26 

7.2 

Change Task to 
Unprivileged Mode 

2,X’58’ 

H.REXS.79 

6.2 

Upspace 

1,X’10’ 

H.IOCS,20 

6.2 

Upspace 

1,X’10’ 

H.IOCS.20 

7.2 

User Name 
Specification 

1,X’74’ 

H.MONS.34 

6.4 

Validate Address 
Range 

2,X’59’ 

H.REXS.33 

6.2 

Validate Address 
Range 

2,X’59’ 

H.REXS.33 

7.2 

Wait I/O 

1,X’3C’ 

H.IOCS.25 

6.2 

Wait I/O 

1^X’3C’ 

H.IOCS.25 

7.2 

Write EOF 

1,X’38’ 

H.IOCS,5 

6.2 

Write Record 

1,X’32’ 

H.IOCS.4 

6.2 

Write Record 

1,X’32’ 

H.IOCS,4 

7.2 

Write EOF 

1,X’38’ 

H.IOCS.5 

7.2 

Exit from Task 
Interrupt Level 

1,X’70’ 

H.REXS.48 

6.2 

Exit from Task 
Interrupt Level 

N/A 

N/A 

7.2 

No-wait I/O End- 
action Return 

1,X’2C’ 

H.IOCS.34 

6.2 

No- wait I/O End- 
action Return 

N/A 

N/A 

7.2 

Exit from Message 
End-action Routine 

1,X’7E’ 

H.REXS,50 

6.2 

Exit from Message 
End-action Routine 

N/A 

N/A 

7.2 
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SVC 
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E.P. 

Ref.Manual 

Section 

M.XMSGR 

Exit from Message 
Receiver 

1,X’5E’ 

HJREXS.39 

6.2 

M_XMSGR 

Exit from Message 
Receiver 

N/A 

N/A 

7.2 

M.XREA 

Exit from Run Request 
End-action Routine 

1,X’7F’ 

H.REXS.51 

6.2 

M_XREA 

Exit from Run Request 
End-action Routine 

N/A 

N/A 

7.2 

M.XRUNR 

Exit Run Receiver 

1,X’7D’ 

H.REXS,49 

6.2 

M_XRUNR 

Exit Run Receiver 

N/A 

N/A 

7.2 

M.XTIME 

Task CPU Execution 
Time 

1^’2D’ 

H.REXS.65 

6.2 

M.XTIME 

Task CPU Execution 
Time 

1,X’2D’ 

HJIEXS.65 

7.2 

N/A 

Allocate File Space 

N/A 

H.VOMM.19 

6.3 

N/A 

Allocate Resource 
Descriptor 

N/A 

H.VOMM.17 

6.3 

N/A 

Create Temporary File 

N/A 

H.VOMM.24 

6.3 

N/A 

Deallocate File Space 

N/A 

H.VOMM,20 

6.3 

N/A 

Deallocate Resource 
Descriptor 

N/A 

H.VOMM.18 

6.3 

N/A 

Debug Link Service 

1,X’66’ 

H.REXS.42 

6.3 

N/A 

Debug Link Service- 
Base Mode 

1,X’66’ 

H.REXS.42 

7.3 

N/A 

Eject/Purge Routine 

1,XW 

H.IOCS.22 

6.3 

N/A 

Eject/Purge Routine- 
Base Mode 

1,X’0D’ 

H. IOCS ,22 

7.3 

N/A 

Erase or Punch Trailer 

1,X’3E’ 

H.IOCS.21 

6.3 

N/A 

Erase or Punch 
Trailer - Base Mode 

1,X’3E’ 

H.IOCS.21 

7.3 

N/A 

Execute Channel 
Program 

1,X’25’ 

H.IOCS.10 

6.3 

N/A 

Execute Channel 
Program - Base Mode 

1,X’25’ 

H.IOCS.10 

7.3 
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Ref.Manual 

Macro 

Description 

SVC 

E.P. 

Section 

N/A 

Get Extended 
Memory Array 

2,X’7F 

H.MEMM.14 

6.3 

N/A 

Get Extended 

Memory Array - Base Mode 

2,X’7F’ 

H.MEMM.14 

7.3 

N/A 

Read/Write 
Authorization File 

N/A 

H.VOMM.25 

6.3 

N/A 

Release FHD Port 

1,X’27’ 

H.IOCS.27 

6.3 

N/A 

Release FHD Port - 
Base Mode 

1,X’27’ 

h.iocs,27 

7.3 

N/A 

Reserve FHD Port 

1,X’26’ 

H.IOCS.24 

6.3 

N/A 

Reserve FHD Port- 
Base Mode 

1,X’26’ 

H.IOCS.24 

7.3 

N/A 

Reserved for 
Interactive Debugger 

2,X’56’ 

H-REXS.30 

N/A 

N/A 

Reserved for Rapid 
File Allocation: 



N/A 


Zero MDT 

2,X’AA’ 

H.MDT.1 



Locate/Read MDT Entry 

2,X’AB’ 

H.MDT.2 



Update/Create MDT Entry 

2,X’AC’ 

H.MDT.3 



Delete MDT Entry 

2,X’AD’ 

H.MDT.4 


N/A 

Set Tabs in UDT 

1,X’59’ 

H.TSM.5 

N/A 

N/A 

TSM Task Detach 

1,X’20’ 

H.TSM.3 

N/A 
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Description 

Macro 

SVC 

Module, 

E.P. 

Volume I 

Ref.Manual 

Section 

Abort Self 

M.BORT 

1,X’57’ 

H.REXS.20 

6.2 


M_BORT 

1,X’57’ 

H.REXS.20 

7.2 

Abort Specified 

M.BORT 

l.X’56’ 

H.REXS.19 

6.2 

Task 

M_BORT 

1,X’56’ 

H.REXS.19 

7.2 

Abort With Extended 

M.BORT 

1,X’62’ 

H.REXS.28 

6.2 

Message 

M_BORT 

1,X’62’ 

H.REXS.28 

7.2 

Acquire Current 

M.QATIM 

2,X’50’ 

H.REXS.74 

6.2 

Date/Time in 
ASCII Format 

M_QATIM 

2,X’50’ 

H.REXS.74 

7.2 

Acquire Current 

M.BTIM 

2,X’50’ 

H.REXS.74 

6.2 

Date/Time in 
Binary Format 

m_btim 

2,X’50’ 

H.REXS.74 

7.2 

Acquire Current 

M.BBTIM 

2,X’50’ 

H.REXS.74 

6.2 

Date/Time in 
Byte Binary Format 

M_BBTIM 

2,X’50’ 

H.REXS.74 

7.2 

Acquire System 

M.GTIM 

2,X’50’ 

H.REXS.74 

6.2 

Date/Time in 
Any Format 

M_GTIM 

2,X’50’ 

H.REXS.74 

7.2 

Activate Program at 

M.TURNON 

1,X’1E’ 

H.REXS.66 

6.2 

Given Time of Day 

M_TURNON 

1,X’1E’ 

H.REXS.66 

7.2 

Activate Task 

M.ACTV 

l.X’52’ 

H.REXS.15 

6.2 


M_ACTV 

l.X’52’ 

H.REXS.15 

7.2 

Activate Task 

M.INT 

1,X’6F’ 

H.REXS.47 

6.2 

Interrupt 

M_INT 

1,X’6F’ 

H.REXS.47 

7.2 

Advance File 

M.FWRD 

1,X’34’ 

H.IOCS.8 

6.2 


M_ AD VANCE 

1,X’34’ 

H.IOCS.8 

7.2 

Advance Record 

M.FWRD 

l.X’33’ 

H.IOCS.7 

6.2 


M_ADVANCE 

l.X’33’ 

H.IOCS.7 

7.2 

Allocate File or 
Peripheral Device 

M.ALOC 

l.X’40’ 

H.MONS.21 

6.4 

Allocate File 
Space 

N/A 

N/A 

H.VOMM.19 

6.3 

Allocate Resource 
Descriptor 

N/A 

N/A 

H.VOMM.17 

6.3 

Arithmetic 

M.TSTE 

1,X’4D’ 

HJREXS.23 

6.2 

Exception Inquiry 

M.TSTE 

1,X’4D’ 

H.REXS.23 

7.2 
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Description 

Macro 

SVC 

Module, 

Ei>. 

Volume I 

Ref.Manual 

Section 

Assign and Allocate 

M.ASSN 

2,X’52’ 

H.REXS.21 

6.2 

Resource 

M_ASSIGN 

2,X’52’ 

H.REXS,21 

7.2 

Backspace File 

M.BACK 

1,X’36’ 

H.IOCS.19 

6.2 


M_BACKSPACE 

1X36’ 

H.IOCS.19 

7.2 

Backspace Record 

M.BACK 

1,X’35’ 

H.IOCS.9 

6.2 


M_BACKSPACE 

1,X’35’ 

H.IOCS.9 

7.2 

Batch Job Entry 

M.BATCH 

2,X’55’ 

H.REXS,27 

6.2 


M_BATCH 

2,X’55’ 

H.REXS.27 

7.2 

Break/Task 

M.BRK 

1,X’6E’ 

H.REXS,46 

6.2 

Interrupt Link/Unlink 

M_BRK 

1,X’6E’ 

H.REXS.46 

7.2 

Change Defaults 

M.DEFT 

2,X’27’ 

H.VOMM.8 

6.2 


M_DEFT 

2,X’27’ 

H.VOMM.8 

7.2 

Change Priority 

M.PRDL 

1,X’4A’ 

H.REXS,9 

6.2 

Level 

M_PRIL 

1,X’4A’ 

H.REXS.9 

7.2 

Change Task to 

M.UPRIV 

2X58’ 

H.REXS.79 

6.2 

Unprivileged Mode 

M_UNPRIVMODE 

2,X’58’ 

H.REXS.79 

7.2 

Change Temporary 

M.PERM 

1,X’76’ 

H.FISE.13 

6.4 

File to Permanent 
Change Temporary 

M.TEMPER 

2,X’28’ 

H.VOMM.9 

6.2 

File to 

M_TEMPFILETOPERM 

2,X’28’ 

H.VOMM.9 

7.2 

Permanent File 
Close File 

M.CLSE 

1,X’39’ 

H.IOCS.23 

6.2 


M_CLSE 

1,X’39’ 

H.IOCS.23 

7.2 

Close Resource 

M.CLOSER 

2,X’43’ 

H.REMM.22 

6.2 


M_CLOSER 

2,X’43’ 

H.REMM,22 

7.2 

Connect Task to 

M.CONN 

1,X’4B’ 

H.REXS.10 

6.2 

Interrupt 

M_CONN 

1,X’4B’ 

H.REXS.10 

7.2 

Convert ASCII 

M.CONABB 

2,X’51’ 

H.REXS,75 

6.2 

Date/Time to 

M_CONABB 

2 ( X’5r 

H.REXS.75 

7.2 

Byte Binary Format 
Convert ASCII 

M.CONASB 

2,X’51’ 

H.REXS.75 

6.2 

Date/Time to 

M_CONASB 

2X51’ 

H.REXS.75 

7.2 

Standard Binary 
Convert ASCII 

M.CONADB 

1,X’28’ 

H.TSM.7 

6.2 

Decimal to Binary 

M_CONADB 

1,X’28’ 

H.TSM.7 

7.2 

Convert ASCII Hex 

M.CONAHB 

1,X’29’ 

H.TSM.8 

6.2 

to Binary 

M_CONAHB 

1,X’29’ 

H.TSM.8 

7.2 
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Volume I 


Description 

Macro 

SVC 

Module, 

E.P. 

Ref.Manual 

Section 

Convert Binary 

M.CONBAF 

2,X’51’ 

H.REXS.75 

6.2 

Date/Time to 
ASCII Format 

M_CONBAF 

2,X’51’ 

H.REXS.75 

7.2 

Convert Binary 

M.CONBBY 

2,X’51’ 

H.REXS.75 

6.2 

Date/Time to 
Byte Binary 

M.CONBBY 

2,X’51’ 

H.REXS.75 

7.2 

Convert Binary to 

M.CONBAD 

1,X’2A’ 

H.TSM.9 

6.2 

ASCII Decimal 

M_CONBAD 

1,X’2A’ 

H.TSM.9 

7.2 

Convert Binary to 

M.CONBAH 

1,X’2B’ 

H.TSM.10 

6.2 

ASCII Hex 

M_CONBAH 

1,X’2B’ 

H.TSM.10 

7.2 

Convert Byte 

M.CONBBA 

2,X’5r 

H.REXS.75 

6.2 

Binary Date/Time 
to ASCII 

M_CONBBA 

2,X’51’ 

H.REXS.75 

7.2 

Convert Byte 

M.CONBYB 

2,X’5r 

H.REXS.75 

6.2 

Binary Date/Time 
to Binary 

M_CONBYB 

2,X’51’ 

H.REXS.75 

7.2 

Convert Pathname 

M.PNAMB 

2,X’2E’ 

H.VOMM.15 

6.2 

to Pathname Block 

M.PNAMB 

2,X’2E’ 

H.VOMM.15 

7.2 

Convert System 

M.CTIM 

2,X’51’ 

H.REXS.75 

6.2 

Date/Time Format 

M_CTIM 

2,X’51’ 

H.REXS.75 

7.2 

Convert Time 

M_CONVERTTIME 

2,X’5I’ 

H.REXS.75 

7.2 

Create Directory 

M.DIR 

2,X’23’ 

H.VOMM.4 

6.2 


M_DIR 

2X23’ 

H.VOMM.4 

7.2 

Create File Control 
Block 

M.DFCB 

N/A 

N/A 

5.9.1 

Create File Control 
Block 

M_CREATEFCB 

N/A 

N/A 

7.2 

Create Memory 

M.MEM 

2X22’ 

H.VOMM.3 

6.2 

Partition 

M_MEM 

2X22’ 

H.VOMM.3 

7.2 

Create Permanent 
File 

M.CREATE 

1,X’75’ 

H.FISE.12 

6.4 

Create Permanent 

M.CPERM 

2,X’20’ 

H.VOMM.1 

6.2 

File 

M_CREATEP 

2X20’ 

H.VOMM.1 

7.2 

Create Temporary 

M.TEMP 

2X21’ 

H.VOMM.2 

6.2 

File 

M_CREATET 

2X21’ 

H.VOMM.2 

7.2 

Create Temporary 
File 

N/A 

N/A 

H.VOMM.24 

6.3 
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Volume I 


Description 

Macro 

SVC 

Module, 

E.P. 

Ref.Manual 

Section 

Create Timer Entry 

M.SETT 

1,X’45’ 

H.REXS.4 

6.2 


M_SETT 

1,X’45’ 

H.REXS.4 

7.2 

Date and Time 

M.DATE 

1,X’15’ 

H.REXS.70 

6.2 

Inquiry 

M_DATE 

1,X’15’ 

H.REXS,70 

7.2 

Deallocate File or 
Peripheral Device 

M.DALC 

i,x’4r 

H.MONS.22 

6.4 

Deallocate File 
Space 

N/A 

N/A 

H.VOMM.20 

6.3 

Deallocate Resource 
Descriptor 

N/A 

N/A 

H.VOMM.18 

6.3 

Deassign and 

M.DASN 

2,X’53’ 

H.REXS.22 

6.2 

Deallocate Resource 

M_DEASSIGN 

2,X’53’ 

H.REXS.22 

7.2 

Debug Link Service 

N/A 

1,X’66’ 

H.REXS.42 

6.3 

Debug Link Service- 
Base Mode 

N/A 

1,X’66’ 

H.REXS,42 

7.3 

Delete Permanent 
File or Non-SYSGEN 
Memory Partition 

M.DELETE 

1,X’77’ 

H.FISE.14 

6.4 

Delete Resource 

M.DELR 

2,X’24’ 

H.VOMM,5 

6.2 


M_DELETER 

2,X’24’ 

H.VOMM.5 

7.2 

Delete Task 

M.DELTSK 

1,X’5A’ 

H.REXS.31 

6.2 


M_DELTSK 

1,X’5A’ 

HJIEXS.31 

7.2 

Delete Timer Entry 

M.DLTT 

1,X’47’ 

H.REXS.6 

6.2 


M_DLTT 

1,X’47’ 

H.REXS,6 

7.2 

Disable Message 

M.DSMI 

1,X’2E’ 

H.REXS.57 

6.2 

Task Interrupt 

M_DSMI 

1,X’2E’ 

H.REXS.57 

7.2 

Disable User Break 

M.DSUB 

1,X’12’ 

H.REXS.73 

6.2 

Interrupt 

M_DSUB 

1,X’12’ 

H.REXS,73 

7.2 

Disconnect Task 

M.DISCON 

1,X’5D’ 

H.REXS.38 

6.2 

from Interrupt 

M_DISCON 

1,X’5D’ 

H.REXS.38 

7.2 

Dismount Volume 

M.DMOUNT 

2,X’4A’ 

H.REMM.19 

6.2 


M_DIS MOUNT 

2,X’4A’ 

H.REMM,19 

7.2 

Eject/Purge Routine 

N/A 

1,X’0D’ 

H.IOCS.22 

6.3 

Eject/Purge Routine- 
Base Mode 

N/A 

1,X’0D* 

H.IOCS.22 

7.3 

Enable Message 

M.ENMI 

1,X’2F’ 

H.REXS.58 

6.2 

Task Interrupt 

M_ENMI 

1,X’2F’ 

H.REXS.58 

7.2 
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Volume I 


Description 

Macro 

SVC 

Module, 

E.P. 

Ref.Manual 

Section 

Enable User Break 

M.ENUB 

1,X’13’ 

H.REXS.72 

6.2 

Interrupt 

M_ENUB 

1,X’13’ 

H.REXS,72 

7.2 

End Action Wait 

M.EAWAIT 

1,X’1D’ 

H.EXEC.40 

6.2 


M_ A W AIT ACTION 

1,X’1D’ 

H.EXEC.40 

7.2 

Erase or Punch 
Trailer 

N/A 

1,X’3E’ 

H.IOCS.21 

6.3 

Erase or Punch 
Trailer - Base Mode 

N/A 

1,X’3E’ 

H.IOCS.21 

7.3 

Exclude Memory 
Partition 

M.EXCLUDE 

2,X’4r 

H.REMM.14 

6.2 

Exclude Shared 
Image 

M_EXCLUDE 

2,X’41’ 

H.REMM.14 

7.2 

Execute Channel 
Program 

N/A 

1,X’25’ 

H.IOCS.10 

6.3 

Execute Channel 
Program - Base Mode 

N/A 

1,X’25’ 

H.IOCS.10 

7.3 

Execute Channel 
Program File 
Control Block 

M_CHANPROGFCB 

N/A 

N/A 

7.2 

Exit from Message 

M.XMEA 

1,X’7E’ 

H.REXS.50 

6.2 

End-action Routine 

M_XMEA 

N/A 

N/A 

7.2 

Exit from Message 

M.XMSGR 

I,X’5E’ 

H.REXS.39 

6.2 

Receiver 

M_XMSGR 

N/A 

N/A 

7.2 

Exit from Run 

M.XREA 

1,X’7F’ 

H.REXS.51 

6.2 

Request End-action 
Routine 

M_XREA 

N/A 

N/A 

7.2 

Exit from Task 

M.BRKXIT 

1,X’70’ 

H.REXS.48 

6.2 

Interrupt Level 

M _BRKXIT 

N/A 

N/A 

7.2 


M.XBRKR 

1,X’70’ 

H.REXS.48 

6.2 


M _XBRKR 

N/A 

N/A 

7.2 

Exit Run Receiver 

M.XRUNR 

1,X’7D’ 

H.REXS.49 

6.2 


M_XRUNR 

N/A 

N/A 

7.2 

Exit With Status 

M_EXTSTS 

2,X’5F’ 

H.REXS.86 

7.2 

Extend File 

M.EXTD 

2,X’25’ 

H.VOMM.6 

6.2 


M_EXTENDFILE 

2,X’25’ 

H.VOMM.6 

7.2 

Free Dynamic 

M.FD 

1,X’6A’ 

H.REMM.9 

6.2 


Extended Indexed 
Data Space 
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Volume I 





Module, 

Ref.Manual 

Description 

Macro 

SVC 

E.P. 

Section 

Free Dynamic Task 
Execution Space 

M.FE 

1,X’68’ 

H.REMM.11 

6.2 

Free Memory in 

M.MEMFRE 

2,X’4C’ 

H.REMM.29 

6.2 

Byte Increments 

M_FREEMEMBYTES 

2,X’4C’ 

H.REMM.29 

7.2 

Free Shared Memory 

M.EXCL 

1,X’79’ 

H.ALOC.14 

6.4 

Get Address Limits 

M.GADRL 

1,X’65’ 

H.REXS.41 

6.2 

Get Address Limits 

M.GADRL2 

2,X’7B’ 

H.REXS.80 

6.2 

Get Base Mode 
Task Address Limits 

M_LIMITS 

2,X’5D’ 

H.REXS.84 

7.2 

Get Command Line 

M.CMD 

2,X’61’ 

H.REXS.88 

6.2 


M_CMD 

2,X’61’ 

H.REXS.88 

7.2 

Get Current Date 
and Time 

M_GETTIME 

2,X’50’ 

H.REXS.74 

7.2 

Get Device Mnemonic 

M.DEVID 

1,X’14’ 

H.REXS.71 

6.2 

or Type Code 

M_DEVID 

1,X’14’ 

H.REXS.71 

7.2 

Get Dynamic 
Extended Data Space 

M.GD 

1,X’69’ 

H.REMM.8 

6.2 

Get Dynamic Extended 
Discontiguous Data Space 

M.GDD 

2,X’7C’ 

H.MEMM.9 

6.2 

Get Dynamic Task 
Execution Space 

M.GE 

1,X’67’ 

H.REMM.10 

6.2 

Get Extended 
Memory Array 

N/A 

2,X’7F’ 

H.MEMM.14 

6.3 

Get Extended 
Memory Array - 
Base Mode 

N/A 

2,X’7F’ 

H.MEMM.14 

7.3 

Get Memory in 

M.MEMB 

2,X’4B’ 

H.REMM.28 

6.2 

Byte Increments 

M_GETMEMBYTES 

2,X’4B’ 

H.REMM.28 

7.2 

Get Message 

M.GMSGP 

1,X’7A’ 

H.REXS.35 

6.2 

Parameters 

M_GMSGP 

1,X’7A’ 

H.REXS.35 

7.2 

Get Real 

M.RADDR 

1,X’0E’ 

H.REXS.90 

6.2 

Physical Address 

M_RADDR 

1,X’0E’ 

H.REXS,90 

7.2 

Get Run Parameters 

M.GRUNP 

1,X’7B’ 

H.BiEXS,36 

6.2 


M_GRUNP 

1,X’7B’ 

H.REXS.36 

7.2 

Get Shared Memory 

M.INCL 

1,X’72’ 

H.ALOC,13 

6.4 
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Description 

Macro 

SVC 

Module, 

E.P. 

Volume I 

Ref.Manual 

Section 

Get Task 

M.ENVRMT 

2,X’5E’ 

H.REXS.85 

6.2 

Environment 

M_ENVRMT 

2,X’5E’ 

H.REXS.85 

7.2 

Get Task Number 

M.ID 

1,X’64’ 

H.REXS.32 

6.2 


M_ID 

1,X’64’ 

H.REXS.32 

7.2 


M.MYID 

1,X’64’ 

H.REXS.32 

6.2 


M_MYID 

1,X’64’ 

H.REXS.32 

7.2 

Get Terminal 

M.GETDEF 

2,X’7A’ 

H.TSM.15 

6.2 

Function Definition 

M_GETDEF 

2,X’7A’ 

H.TSM.15 

7.2 

Get TSA Start 

M.GTSAD 

2,X’7D’ 

H.REXS.91 

6.2 

Address 

M_GTSAD 

2,X’7D’ 

H.REXS.91 

7.2 

Get User Context 

M_GETCTX 

2,X’70’ 

H.EXEC.41 

7.2 

Include Memory 
Partition 

M.INCLUDE 

2,X’40’ 

H.REMM.12 

6.2 

Include Shared 
Image 

MJNCLUDE 

2,X’40’ 

H.REMM.12 

7.2 

Load and Execute 

M.DEBUG 

1,X’63’ 

H.REXS.29 

6.2 

Interactive Debugger 

M_DEBUG 

1,X’63’ 

H.REXS.29 

7.2 

Load Overlay Segment 

M.OLAY 

1,X’50’ 

H.REXS.13 

6.2 

Load and Execute 
Overlay 


i,x’5r 

H.REXS.14 

6.2 

Log Resource 

M.LOGR 

2,X’29’ 

H.VOMM.IO 

6.2 

or Directory 

M_LOGR 

2,X’29’ 

H.VOMM.IO 

7.2 

Memory Address 

M.ADRS 

1,X’44’ 

H.REXS.3 

6.2 

Inquiry 

M_ADRS 

1,X’44’ 

H.REXS.3 

7.2 

Memory Dump 

M.DUMP 

1,X’4F’ 

H.REXS.12 

6.2 

Request 

M_DUMP 

1,X’4F’ 

H.REXS.12 

7.2 

Modify Descriptor 

M.MOD 

2,X’2A’ 

H.VOMM.11 

6.2 


M_MOD 

2,X’2A’ 

H.VOMM.ll 

7.2 

Modify Descriptor 

M.MODU 

2,X’31’ 

H.VOMM.26 

6.2 

User Area 

M_MODU 

2,X’31’ 

H.VOMM.26 

7.2 

Mount Volume 

M.MOUNT 

2,X’49’ 

H.REMM.17 

6.2 


M_MOUNT 

2,X’49’ 

H.REMM.17 

7.2 

Move Data to 

M.MOVE 

2,X’62’ 

H.REXS.89 

6.2 

User Address 

M_MOVE 

2,X’62’ 

H.REXS.89 

7.2 

No- wait I/O End- 

M.XIEA 

1,X’2C’ 

H.IOCS.34 

6.2 

action Return 

M_XIEA 

N/A 

N/A 

7.2 

Open File 

M.FILE 

1,X’30’ 

H.IOCS.l 

6.4 
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Volume I 


Description 

Macro 

SVC 

Module, 

E.P. 

Ref.Manual 

Section 

Open Resource 

M.OPENR 

2,X’42’ 

H.REMM.21 

6.2 


M_OPENR 

2,X’42’ 

H.REMM.21 

7.2 

Parameter Task 

M.PTSK 

1,X’5F’ 

H.REXS.40 

6.2 

Activation 

M_PTSK 

1,X’5F’ 

H.REXS.40 

7.2 

Permanent File 
Address Inquiry 

M.FADD 

1,X’43’ 

H.MONS.2 

6.4 

Permanent File Log 

M.LOG 

1,X’73’ 

H.MONS.33 

6.4 

Physical Device 
Inquiry 

M.PDEV 

1,X’42’ 

H.MONS.1 

6.4 

Physical Memory 

M.OSREAD 

2,X’7E’ 

H.REXS.93 

6.2 

Read 

M_OSREAD 

2,X’7E’ 

H.REXS.93 

7.2 

Physical Memory 

M.OSWRIT 

2,X’AF’ 

H.REXS.94 

6.2 

Write 

M_OSWRIT 

2,X’AF’ 

H.REXS.94 

7.2 

Program Hold 

M.HOLD 

1,X’58’ 

H.REXS.25 

6.2 

Request 

M_HOLD 

1,X’58’ 

H.REXS.25 

7.2 

Put User Context 

M_PUTCTX 

2,X’71’ 

H.EXEC.42 

7.2 

Read Descriptor 

M.LOC 

2,X’2C’ 

H.VOMM.13 

6.2 


M_READD 

2,X’2C’ 

H.VOMM,13 

7.2 

Read Record 

M.READ 

1,X’31’ 

H.IOCS.3 

6.2 


M_READ 

i,x’3r 

H.IOCS.3 

7.2 

Read/Write 
Authorization File 

N/A 

N/A 

H.VOMM.25 

6.3 

Receive Message 

M.RCVR 

1,X’6B’ 

H.REXS.43 

6.2 

Link Address 

M_RCVR 

1,X’6B’ 

H.REXS.43 

7.2 

Reconstruct 

M.PNAM 

2,X’2F’ 

H.VOMM,16 

6.2 

Pathname 

M_CONSTRUCTPATH 

2,X’2F’ 

H.VOMM.16 

7.2 

Reformat RRS Entry 

M.NEWRRS 

2,X’54’ 

H.REXS.76 

6.2 

Reinstate Privilege 

M.PRIV 

2,X’57’ 

H.REXS.78 

6.2 

Mode to Privilege 
Task 

M_PRIVMODE 

2,X’57’ 

H.REXS/78 

7.2 

Release Channel 

M.RRES 

1,X’3B’ 

H.IOCS,13 

6.2 

Reservation 

M_RRES 

1,X’3B’ 

H.IOCS.13 

7.2 

Release Dual-ported 

M.RELP 

1,X’27’ 

H.IOCS.27 

6.2 

Disc/Set Dual-channel 
ACM Mode 

M_RELP 

1,X’27’ 

H.IOCS/27 

7.2 

Release Exclusive 
File Lock 

M.FXLR 

1,X’22’ 

H.FISE.23 

6.4 

Release Exclusive 

M.UNLOCK 

2,X’45’ 

HJREMM.24 

6.2 

Resource Lock 

M_UNLOCK 

2,X’45’ 

H.REMM.24 

7.2 
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Description 

Macro 

SVC 

Module, 

E.P. 

Volume I 

Ref.Manual 

Section 

Release FHD Port 

N/A 

1,X’27’ 

H.IOCS.27 

6.3 

Release FHD Port- 

N/A 

1,X’27’ 

H.IOCS.27 

7.3 

Base Mode 





Release 

M.FSLR 

1,X’24’ 

H.FISE.25 

6.4 

Synchronization 





File Lock 





Release Synchronous 

M.UNSYNC 

2,X’47’ 

H.REMM.26 

6.2 

Resource Lock 

MJUNSYNC 

2,X’47’ 

H.REMM.26 

7.2 

Rename File 

M.RENAM 

2,X’2D’ 

H.VOMM.14 

6.2 


M_RENAME 

2,X’2D’ 

H.VOMM.14 

7.2 

Replace 

M.REPLAC 

2,X’30’ 

H.VOMM.23 

6.2 

Permanent File 

M_REPLACE 

2,X’30’ 

H.VOMM.23 

7.2 

Reserve Channel 

M.RSRV 

1,X’3A’ 

H.IOCS.12 

6.2 


M_RSRV 

1,X’3A’ 

H.IOCS.12 

7.2 

Reserve Dual-ported 

M.RESP 

1,X’26’ 

H.IOCS.24 

6.2 

Disc/Set Single-channel 

M.RESP 

1,X’26’ 

H.IOCS.24 

7.2 

ACM Mode 





Reserve FHD Port 

N/A 

1,X’26’ 

H.IOCS.24 

6.3 

Reserve FHD Port- 

N/A 

1,X’26’ 

H.IOCS.24 

7.3 

Base Mode 





Reserved for 

N/A 

2,X’56’ 

H.REXS.30 

N/A 

Interactive 





Debugger 





Reserved for 

N/A 



N/A 

Rapid File 





Allocation: 





Zero MDT 


2,X’AA’ 

H.MDT.1 


Locate/Read MDT Entry 


2,X’AB’ 

H.MDT.2 


Update/Create MDT Entry 

2,X’AC’ 

H.MDT.3 


Delete MDT Entry 


2,X’AD’ 

H.MDT.4 


Reset Option Lower 

M.ROPL 

2,X’78’ 

H.TSM.14 

6.2 


M_ROPL 

2,X’78’ 

H.TSM.14 

7.2 

Resource Inquiry 

M.INQUIRY 

2,X’48’ 

H.REMM.27 

6.2 


M_INQUIRER 

2,X’48’ 

H.REMM.27 

7.2 

Resourcemark Lock 

M.RSML 

l.X’19’ 

H.REXS.62 

6.2 


M_RSML 

1,X’19’ 

H.REXS.62 

7.2 

Resourcemark Unlock 

M.RSMU 

1,X’1A’ 

H.REXS.63 

6.2 


M_RSMU 

1,X’1A’ 

H.REXS.63 

7.2 
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w 



Alphabetic Listing 


Description 

Macro 

SVC 

Module, 

E.P. 

Volume I 

Ref.Manual 

Section 

Resume Task 

M.SUME 

1,X’53’ 

H.REXS.16 

6.2 

Execution 

M_SUME 

l.X’53’ 

H.REXS,16 

7.2 

Rewind File 

M.RWND 

1,X’37’ 

H.IOCS.2 

6.2 


M_REWIND 

1,X’37’ 

H.IOCS.2 

7.2 

Rewrite Descriptor 

M.REWRIT 

2,X’2B’ 

H.VOMM,12 

6.2 


M_REWRIT 

2,X’2B’ 

H.VOMM.12 

7.2 

Rewrite Descriptor 

M.REWRTU 

2,X’32’ 

H.VOMM.27 

6.2 

User Area 

M_REWRTU 

2,X’32’ 

H.VOMM.27 

7.2 

Scan Terminal 

M.TSCAN 

1,X’5B’ 

H.TSM.2 

6.2 

Input Buffer 

M.TSCAN 

1,X’5B’ 

H.TSM.2 

7.2 

Send Message to 

M.SMSGR 

1,X’6C’ 

H.REXS.44 

6.2 

Specified Task 

M_SMSGR 

1,X’6C’ 

H.REXS.44 

7.2 

Send Run Request 

M.SRUNR 

1,X’6D’ 

H.REXS.45 

6.2 

to Specified Task 

M_SRUNR 

1,X’6D’ 

H.REXS.45 

7.2 

Set Asynchronous 

M.ASYNCH 

1,X’1C 

H.REXS.68 

6.2 

Task Interrupt 

M_ASYNCH 

1,X’1C’ 

H.REXS.68 

7.2 

Set Exception 
Handler 

M_SETEXA 

2,X’5C’ 

H.REXS.83 

7.2 

Set Exception 
Return Address 

M_SETERA 

2,X’79’ 

H.REXS.81 

7.2 

Set Exclusive 
File Lock 

M.FXLS 

i,x’2r 

H.FISE.22 

6.4 

Set Exclusive 

M.LOCK 

2,X’44’ 

H.REMM.23 

6.2 

Resource Lock 

M_LOCK 

2,X’44’ 

H.REMM.23 

7.2 

Set IPU Bias 

M.IPUBS 

2,X’5B’ 

H.REXS.82 

6.2 


M_IPUBS 

2,X’5B’ 

H.REXS.82 

7.2 

Set Option Lower 

M.SOPL 

2,X’77’ 

H.TSM,13 

6.2 


M_SOPL 

2,X’77’ 

H.TSM,13 

7.2 

Set Synchronization 
File Lock 

M.FSLS 

1,X’23’ 

H.FISE.24 

6.4 

Set Synchronous 

M.SETSYNC 

2,X’46’ 

H.REMM.25 

6.2 

Resource Lock 

MJSETSYNC 

2,X’46’ 

H.REMM,25 

7.2 

Set Synchronous 

M.SYNCH 

1,X’1B’ 

H.REXS.67 

6.2 

Task Interrupt 

M_SYNCH 

1,X’1B’ 

H.REXS,67 

7.2 

Set Tabs in UDT 

N/A 

1,X’59’ 

H.TSM,5 

N/A 
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Volume I 


Description 

Macro 

SVC 

Module, 

E.P. 

Ref.Manual 

Section 

Set User Abort 

M.SUAR 

1,X’60’ 

H.REXS.26 

6.2 

Receiver Address 

M_SUAR 

1,X’60’ 

H.REXS.26 

7.2 

Set User Status 

M.SETS 

1,X’48’ 

H.REXS.7 

6.2 

Word 

M_SETS 

1,X’48’ 

H.REXS.7 

7.2 

Share Memory with 

M.SHARE 

1,X’71’ 

H.ALOC.12 

6.4 

Another Task 

Submit Job from 

M.CDJS 

1,X’61’ 

H.MONS.27 

6.4 

Disc File 

Suspend/Resume 

M.SURE 

5,X’00’ 

N/A 

6.2 


M_SURE 

5,X’00’ 

N/A 

7.2 

Suspend Task 

M.SUSP 

1,X’54’ 

HJREXS.17 

6.2 

Execution 

MJSUSP 

1,X’54’ 

H.REXS.17 

7.2 

System Console Type 

M.TYPE 

1,X’3F 

H.IOCS.14 

6.2 


M_TYPE 

1,X’3F 

H.IOCS.14 

7.2 

System Console Wait 

M.CWAT 

1,X’3D’ 

H.IOCS.26 

6.2 


M_CWAT 

1,X’3D’ 

H.IOCS.26 

7.2 

Task CPU Execution 

M.XTIME 

1,X’2D’ 

H.REXS.65 

6.2 

Time 

M_XTIME 

1,X’2D’ 

H.REXS.65 

7.2 

Task Option 

M.PGOD 

2,X’C0’ 

H.REXS.95 

6.2 

Doubleword Inquiry 

M_OPTIONDWORD 

2,X’C0’ 

H.REXS.95 

7.2 

Task Option Word 

M.PGOW 

1^X’4C’ 

H.REXS.24 

6.2 

Inquiry 

M_OPTTONW ORD 

1,X’4C’ 

H.REXS.24 

7.2 

Terminate Task 

MJEXIT 

1,X’55’ 

H.REXS.18 

6.2 

Execution 

M_EXIT 

1,X’55’ 

H.REXS.18 

7.2 

Test Timer Entry 

M.TSTT 

1,X’46’ 

H.REXS.5 

6.2 


mtstt 

1,X’46’ 

H.REXS.5 

7.2 

Test User Status 

M.TSTS 

1,X’49’ 

H.REXS.8 

6.2 

Word 

M.TSTS 

1,X’49’ 

H.REXS.8 

7.2 

Time-of-Day Inquiry 

M.TDAY 

1,X’4E’ 

H.REXS.11 

6.2 


M_TDAY 

1,X’4E’ 

HJtEXS.ll 

7.2 

Trap On-line User’s 

M.TBRKON 

1,X’5C’ 

H.TSM.6 

6.2 

Task 

M_TBRKON 

1,X’5C’ 

H.TSM.6 

7.2 

Truncate File 

M.TRNC 

2,X’26’ 

H.VOMM.7 

6.2 


M_TRUNCATE 

2,X’26’ 

H.VOMM.7 

7.2 

TSM Procedure 

M.TSMPC 

2,X’AE’ 

H.TSM.17 

6.2 

Call 

M.TSMPC 

2,X’AE’ 

H.TSM.17 

7.2 

TSM Task Detach 

N/A 

1,X’20’ 

H.TSM.3 

N/A 

Unlock and Dequeue 

M.SMULK 

1,X’1F’ 

H.ALOC.19 

6.4 

Shared Memory 
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Description 

Macro 

Upspace 

M.UPSP 

MJUPSP 

User Name 
Specification 

M.USER 

Validate Address 
Range 

M.VADDR 

M_VADDR 

Wait for Any 
No-wait Operation 
Complete, Message 
Interrupt, or Break 
Interrupt 

M.ANYW 

M_ANYWAIT 

Wait I/O 

M.WAIT 

M_WAIT 

Write EOF 

M.WEOF 

M.WRITEEOF 

Write Record 

M.WRIT 

M_WRITE 


SVC 

Module, 

E.P. 

Volume I 

Ref.Manual 

Section 

1,X’10’ 

H.IOCS.20 

6.2 

l.X’10’ 

H.IOCS.20 

7.2 

1,X’74’ 

H.MONS.34 

6.4 

2,X’59’ 

H.REXS,33 

6.2 

2,X’59’ 

H.REXS.33 

7.2 

1,X’7C’ 

H.REXS.37 

6.2 

1,X’7C’ 

H.REXS.37 

7.2 


1,X’3C’ 

H.IOCS.25 

6.2 

1,X’3C’ 

H.IOCS.25 

7.2 

l.X’38’ 

H.IOCS.5 

6.2 

1,X’38’ 

H.IOCS.5 

7.2 

1,X’32’ 

H.IOCS.4 

6.2 

1,X’32’ 

H.IOCS.4 

7.2 
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B.3 SVC Listing 


''O; 

vy 


SVC 

Description 

Module, 

E.P. 

Macro 

Volume I 

Ref.Manual 

Section 

00-0A 

Reserved 




OB 

Reserved for 





Vector Processor 




OC 

Reserved 




OD 

Eject/Purge 

H.IOCS.22 

N/A 

6.3 


Routine 





Eject/Purge 

H.IOCS.22 

N/A 

7.3 


Routine - Base Mode 




OE 

Get Real 

H.REXS.90 

M.RADDR 

6.2 


Physical Address 


M.RADDR 

7.2 

OF 

Reserved for 


N/A 

N/A 


Vector Processor 




10 

Upspace 

H.IOCS.20 

M.UPSP 

6.2 




M_UPSP 

7.2 

11 

Reserved 




12 

Disable User 

H.REXS.73 

M.DSUB 

6.2 


Break Interrupt 


M_DSUB 

7.2 

13 

Enable User 

H.REXS.72 

M.ENUB 

6.2 


Break Interrupt 


M_ENUB 

7.2 

14 

Get Device Mnemonic 

H.REXS.71 

M.DEVID 

6.2 


or Type Code 


M.DEVID 

7.2 

15 

Date and Time 

H.REXS.70 

M.DATE 

6.2 


Inquiry 


M_DATE 

7.2 

16 

ADI Maximum 

N/A 

M.ADIMAX 

N/A 


IOCBs 




17 

ADI I/O 

N/A 

M.ADIO 

N/A 

18 

ADIEAI 

N/A 

M.ADIEAI 

N/A 

19 

Resourcemark 

H.REXS.62 

M.RSML 

6.2 


Lock 


M_RSML 

7.2 

1A 

Resourcemark 

H.REXS.63 

M.RSMU 

6.2 


Unlock 


M_RSMU 

7.2 

IB 

Set Synchronous 

H.REXS.67 

M.SYNCH 

6.2 


Task Interrupt 


M_SYNCH 

7.2 

1C 

Set Asynchronous 

H.REXS.68 

M.ASYNCH 

6.2 


Task Interrupt 


M_ASYNCH 

7.2 
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SVC Listing 






Volume I 

SVC 


Module, 


Ref.Manual 

1,XW 

Description 

E.P. 

Macro 

Section 

ID 

End Action Wait 

H.EXEC.40 

M.EAWAIT 

6.2 




M_AWAIT ACTION 

7.2 

IE 

Activate Program 

H.REXS.66 

M.TURNON 

6.2 


at Given Time of Day 


M_TURNON 

7.2 

IF 

Unlock and 

Dequeue Shared Memory 

H.ALOC.19 

M.SMULK 

6.4 

20 

TSM Task Detach 

H.TSM.3 

N/A 

N/A 

21 

Set Exclusive 
File Lock 

H.FISE.22 

M.FXLS 

6.4 

22 

Release 

Exclusive File Lock 

H.FISE,23 

M.FXLR 

6.4 

23 

Set Synchronization 
File Lock 

H.FISE.24 

M.FSLS 

6.4 

24 

Release 

Synchronization 
File Lock 

H.FISE.25 

M.FSLR 

6.4 

25 

Execute Channel 

H.IOCS.10 

N/A 

6.3 


Program 

Execute Channel 
Program - Base Mode 

H.IOCS.10 

N/A 

7.3 

26 

ReserveFHD Port 

H.IOCS.24 

N/A 

6.3 


Reserve FHD Port - 


N/A 

7.3 


Base Mode 
Reserve Dual- 


M.RESP 

6.2 


ported Disc/Set 
Single-channel 
ACM Mode 


MJRESP 

7.2 

27 

Release FHD Port 

H.IOCS.27 

N/A 

6.3 


Release FHD Port - 


N/A 

7.3 


Base Mode 
Release Dual- 


M.RELP 

6.2 


ported Disc/Set 
Dual-channel 
ACM Mode 


M_RELP 

7.2 

28 

Convert ASCII 

H.TSM,7 

M.CONADB 

6.2 


Decimal to Binary 


M_CONADB 

7.2 

29 

Convert ASCII 

H.TSM.8 

M.CONAHB 

6.2 


Hex to Binary 


M_CONAHB 

7.2 
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SVC 
1 ,X’nn' 

Description 

Module, 

E.P. 

2A 

Convert Binary 
to ASCII Decimal 

H.TSM.9 

2B 

Convert Binary 
to ASCII Hex 

H.TSM.10 

2C 

No-wait I/O End-action 
Return 

H.IOCS.34 

2D 

Task CPU Execution 
Time 

H.REXS.65 

2E 

Disable Message 
Task Interrupt 

H.REXS.57 

2F 

Enable Message 
Task Interrupt 

H.REXS.58 

30 

Open File 

H.IOCS.1 

31 

Read Record 

H.IOCS.3 

32 

Write Record 

H.IOCS.4 

33 

Advance Record 

H.IOCS.7 

34 

Advance File 

H.IOCS.8 

35 

Backspace Record 

H.IOCS.9 

36 

Backspace File 

H.IOCS.19 

37 

Rewind File 

H.IOCS.2 

38 

Write EOF 

H.IOCS.5 

39 

Close File 

H.IOCS,23 

3A 

Reserve Channel 

H.IOCS,12 

3B 

Release Channel 
Reservation 

H.IOCS,13 



Volume I 

r. 

Macro 

Ref.Manual 

Section 


M.CONBAD 

6.2 


M_CONBAD 

7.2 


M.CONBAH 

6.2 


M.CONBAH 

7.2 


M.XIEA 

6.2 


M.XTIME 

6.2 


M_XTIME 

7.2 


M.DSMI 

6.2 


M_DSMI 

7.2 


M.ENMI 

6.2 


m_enmi 

7.2 


M.FILE 

6.4 


M.READ 

6.2 


M_READ 

7.2 


M.WRIT 

6.2 


MJWRITE 

7.2 

/■- 

M.FWRD 

6.2 


M_ADVANCE 

7.2 


M.FWRD 

6.2 


M_AD VANCE 

7.2 


M.BACK 

6.2 


m_backspace 

7.2 


M.BACK 

6.2 


M_BACKSPACE 

7.2 


M.RWND 

6.2 


M_REWIND 

7.2 


M.WEOF 

6.2 


M_WRITEEOF 

7.2 


M.CLSE 

6.2 


M_CLSE 

7.2 


M.RSRV 

6.2 


M_RSRV 

7.2 


M.RRES 

6.2 


M.RRES 

7.2 



O 
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SVC 

l.X’nn’ 

Description 

Module, 

E.P. 

Macro 

Volume I 

Ref.Manual 

Section 

3C 

Wait VO 

H.IOCS.25 

M.WAIT 

6.2 




M_WAIT 

7.2 

3D 

System Console 

H.IOCS.26 

M.CWAT 

6.2 


Wait 


M_CWAT 

7.2 

3E 

Erase or Punch 

H.IOCS.21 

N/A 

6.3 


Trailer 





Erase or Punch 

H.IOCS.21 

N/A 

7.3 


Trailer - Base Mode 




3F 

System Console 

H.IOCS,14 

M.TYPE 

6.2 


Type 


M_TYPE 

7.2 

40 

Allocate File or 

H.MONS.21 

M.ALOC 

6.4 


Peripheral Device 




41 

Deallocate File 

H.MONS.22 

M.DALC 

6.4 


or Peripheral Device 




42 

Physical Device 

H.MONS.1 

M.PDEV 

6.4 


Inquiry 




43 

Permanent File 

H.MONS.2 

M.FADD 

6.4 


Address Inquiry 




44 

Memory Address 

H.REXS.3 

M.ADRS 

6.2 


Inquiry 


M_ADRS 

7.2 

45 

Create Timer 

H.REXS.4 

M.SETT 

6.2 


Entry 


M_SETT 

7.2 

46 

Test Timer Entry 

H.REXS.5 

M.TSTT 

6.2 




mtstt 

7.2 

47 

Delete Timer 

H.REXS.6 

M.DLTT 

6.2 


Entry 


M_DLTT 

7.2 

48 

Set User Status 

H.REXS,7 

M.SETS 

6.2 


Word 


M_SETS 

7.2 

49 

Test User Status 

H.REXS.8 

M.TSTS 

6.2 


Word 


M_TSTS 

7.2 

4A 

Change Priority 

H.REXS.9 

M.PRIL 

6.2 


Level 


M_PRIL 

7.2 

4B 

Connect Task to 

H.REXS.10 

M.CONN 

6.2 


Interrupt 


M_CONN 

7.2 

4C 

Task Option Word 

H.REXS.24 

M.PGOW 

6.2 


Inquiry 


M_OPTIONWORD 7.2 
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Volume I 

SVC Module, Ref.Manual 


l.X’n/t’ 

Description 

E.P. 

Macro 

Section 

4D 

Arithmetic 

H.REXS.23 

M.TSTE 

6.2 


Exception Inquiry 


M_TSTE 

7.2 

4E 

Time-of-Day Inquiry 

H.REXS.ll 

M.TDAY 

6.2 




M_TDAY 

7.2 

4F 

Memory Dump 

H.REXS.12 

M.DUMP 

6.2 


Request 


M_DUMP 

7.2 

50 

Load Overlay Segment 

H.REXS.13 

M.OLAY 

6.2 

51 

Load and Execute 
Overlay 

H.REXS,14 

M.OLAY 

6.2 

52 

Activate Task 

H.REXS.15 

M.ACTV 

6.2 




M_ACTV 

7.2 

53 

Resume Task 

H.REXS.16 

M.SUME 

6.2 


Execution 


M_SUME 

7.2 

54 

Suspend Task 

H.REXS.17 

M.SUSP 

6.2 


Execution 


M_SUSP 

7.2 

55 

Terminate Task 

H.REXS.18 

M.EXIT 

6.2 


Execution 


M_EXIT 

7.2 

56 

Abort Specified 

H.REXS.19 

M.BORT 

6.2 


Task 


M_BORT 

7.2 

57 

Abort Self 

H.REXS.20 

M.BORT 

6.2 




M.BORT 

7.2 

58 

Program Hold 

H.REXS.25 

M.HOLD 

6.2 


Request 


M.HOLD 

7.2 

59 

Set Tabs in UDT 

H.TSM,5 

N/A 

N/A 

5A 

Delete Task 

H.REXS.31 

M.DELTSK 

6.2 




M.DELTSK 

7.2 

5B 

Scan Terminal 

H.TSM,2 

M.TSCAN 

6.2 


Input Buffer 


M.TSCAN 

7.2 

5C 

Trap On-line 

H.TSM.6 

M.TBRKON 

6.2 


User’s Task 


M.TBRKON 

7.2 

5D 

Disconnect Task 

H.REXS.38 

M.DISCON 

6.2 


from Interrupt 


M.DISCON 

7.2 

5E 

Exit from 
Message Receiver 

H.REXS.39 

M.XMSGR 

6.2 

5F 

Parameter Task 

H.REXS.40 

M.PTSK 

6.2 


Activation 


M.PTSK 

7.2 
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System Services Cross-Reference 



SVC Listing 






Volume I 

SVC 


Module, 


Ref.Manual 

l.XVrn’ 

Description 

E.P. 

Macro 

Section 

60 

Set User Abort 

H.REXS.26 

M.SUAR 

6.2 


Receiver Address 


M_SUAR 

7.2 

61 

Submit Job from 
Disc File 

H.MONS.27 

M.CDJS 

6.4 

62 

Abort With 

H.REXS.28 

M.BORT 

6.2 


Extended Message 


M_BORT 

7.2 

63 

Load and Execute 

H.REXS.29 

M.DEBUG 

6.2 


Interactive Debugger 


M.DEBUG 

7.2 

64 

Get Task Number 

H.REXS.32 

M.ID 

6.2 




M_ID 

7.2 




M.MYID 

6.2 




M_MYID 

7.2 

65 

Get Address 
Limits 

H.REXS.41 

M.GADRL 

6.2 

66 

Debug Link 
Service 

H.REXS.42 

N/A 

6.3 


Debug Link 
Service - Base Mode 

H.REXS.42 

N/A 

7.3 

67 

Get Dynamic Task 
Execution Space 

H-REMM.10 

M.GE 

6.2 

68 

Free Dynamic 
Task Execution Space 

H.REMM.11 

M.FE 

6.2 

69 

Get Dynamic 
Extended Data Space 

H.REMM.8 

M.GD 

6.2 

6A 

Free Dynamic 
Extended Indexed 
Data Space 

H.REMM.9 

M.FD 

6.2 

6B 

Receive Message 

H.REXS.43 

M.RCVR 

6.2 


Link Address 


M_RCVR 

7.2 

6C 

Send Message to 

H.REXS.44 

M.SMSGR 

6.2 


Specified Task 


MJSMSGR 

7.2 

6D 

Send Run Request 

H.REXS.45 

M.SRUNR 

6.2 


to Specified Task 


M_SRUNR 

7.2 

6E 

Break/Task 

H.REXS.46 

M.BRK 

6.2 


Interrupt 

Link/Unlink 


M_BRK 

7.2 

6F 

Activate Task 

HJIEXS.47 

M.INT 

6.2 


Interrupt 


M_INT 

7.2 
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SVC Listing 


Volume I 


SVC 


Module, 


Ref.Manual 

l,X’nn' 

Description 

E.P. 

Macro 

Section 

70 

Exit from Task 

H.REXS.48 

M.BRKXIT 

6.2 


Interrupt Level 


M.XBRKR 

6.2 

71 

Share Memory 
with Another Task 

H.ALOC.12 

M.SHARE 

6.4 

72 

Get Shared Memory 

H.ALOC.13 

M.INCL 

6.4 

73 

Permanent File Log 

H.MONS.33 

M.LOG 

6.4 

74 

User Name Specification 

H.MONS,34 

M.USER 

6.4 

75 

Create Permanent File 

H.FISE.12 

M.CREATE 

6.4 

76 

Change Temporary 
File to Permanent 

H.F1SE,13 

M.PERM 

6.4 

77 

Delete Permanent File 
or Non-SYSGEN 
Memory Partition 

H.FISE,14 

M.DELETE 

6.4 

78 

Reserved 




79 

Free Shared Memory 

H.ALOC.14 

M.EXCL 

6.4 

7A 

Get Message Parameters 

H.REXS.35 

M.GMSGP 

6.2 




M_GMSGP 

7.2 

7B 

Get Run Parameters 

H.REXS.36 

M.GRUNP 

6.2 




M_GRUNP 

7.2 

7C 

Wait for Any 

H.REXS.37 

M.ANYW 

6.2 


No-wait Operation 
Complete, Message 
Interrupt, or Break 
Interrupt 


M_ANYWAIT 

7.2 

7D 

Exit Run Receiver 

H.REXS.49 

M.XRUNR 

6.2 

7E 

Exit from Message 
End-action Routine 

H.REXS.50 

M.XMEA 

6.2 

7F 

Exit from Run 
Request End-action 
Routine 

H.REXS.51 

M.XREA 

6.2 

80-FFF 

Available for 





customer use 
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SVC Listing 


Volume I 


SVC 


Module, 


Ref.Manual 

2,X’nn’ 

Description 

E.P. 

Macro 

Section 

OO-IF 

Reserved 




20 

Create Permanent 

H.VOMM,l 

M.CPERM 

6.2 


File 


M_CREATEP 

7.2 

21 

Create Temporary 

H.VOMM.2 

M.TEMP 

6.2 


File 


M_CREATET 

7.2 

22 

Create Memory 

H.VOMM.3 

M.MEM 

6.2 


Partition 


M_MEM 

7.2 

23 

Create Directory 

H.VOMM.4 

M.DIR 

6.2 




M_DIR 

7.2 

24 

Delete Resource 

H.VOMM.5 

M.DELR 

6.2 




M_DELETER 

7.2 

25 

Extend File 

H.VOMM,6 

M.EXTD 

6.2 




M_EXTENDFILE 

7.2 

26 

Truncate File 

H.VOMM.7 

M.TRNC 

6.2 




MJTRUNCATE 

7.2 

27 

Change Defaults 

H.VOMM.8 

M.DEFT 

6.2 




M_DEFT 

7.2 

28 

Change Temporary 

H.VOMM.9 

M.TEMPER 

6.2 


File to Permanent File 


M_TEMPFILETOPERM 

7.2 

29 

Log Resource or 

H.VOMM,10 

M.LOGR 

6.2 


Directory 


M_LOGR 

7.2 

2A 

Modify Descriptor 

H.VOMM.11 

M.MOD 

6.2 




M_MOD 

7.2 

2B 

Rewrite 

H.VOMM.12 

M.REWRIT 

6.2 


Descriptor 


M_REWRIT 

7.2 

2C 

Read Descriptor 

H.VOMM,13 

M.LOC 

6.2 




M_READD 

7.2 

2D 

Rename File 

H.VOMM.14 

M.RENAM 

6.2 




M_RENAME 

7.2 

2E 

Convert Pathname 

H.VOMM,15 

M.PNAMB 

6.2 


to Pathname Block 


M_PNAMB 

7.2 

2F 

Reconstruct 

H.VOMM.16 

M.PNAM 

6.2 


Pathname 


M_CONSTRUCTPATH 

7.2 

30 

Replace 

H.VOMM.23 

M.REPLAC 

6.2 


Permanent File 


M_REPLACE 

7.2 

31 

Modify Descriptor 

H.VOMM.26 

M.MODU 

6.2 


User Area 


M_MODU 

7.2 
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SVC Listing 


SVC 

2,X’nn’ 

Description 

Module, 

E.P. 

32 

Rewrite 

Descriptor User Area 

H.VOMM.27 

33 

DBX Interface to 
H.PTRAC 

N/A 

34 

Reserved 
for H.PTRAC 


35-3F 

Reserved 


40 

Include Memory 
Partition 

H.REMM.12 


Include Shared 
Image 


41 

Exclude Memory 
Partition 

H.REMM.14 


Exclude Shared 
Image 


42 

Open Resource 

H.REMM.21 

43 

Close Resource 

HJREMM.22 

44 

Set Exclusive 
Resource Lock 

H.REMM.23 

45 

Release Exclusive 
Resource Lock 

H.REMM.24 

46 

Set Synchronous 
Resource Lock 

H.REMM.25 

47 

Release 
Synchronous 
Resource Lock 

H.REMM.26 

48 

Resource Inquiry 

H.REMM.27 

49 

Mount Volume 

H.REMM.17 

4A 

Dismount Volume 

H.REMM.19 

4B 

Get Memory in 
Byte Increments 

H.REMM.28 
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Macro 

Volume I 

Ref.Manual 

Section 

M.REWRTU 

6.2 

M_REWRTU 

7.2 

N/A 

N/A 


M.INCLUDE 

6.2 

M .INCLUDE 

7.2 

M.EXCLUDE 

6.2 

M .EXCLUDE 

7.2 

M.OPENR 

6.2 

M.OPENR 

7.2 

M.CLOSER 

6.2 

M.CLOSER 

7.2 

M.LOCK 

6.2 

M.LOCK 

7.2 

M.UNLOCK 

6.2 

M.UNLOCK 

7.2 

M.SETSYNC 

6.2 

M.SETSYNC 

7.2 

M.UNSYNC 

6.2 

M.UNSYNC 

7.2 

M.INQUIRY 

6.2 

M.INQUIRER 

7.2 

M.MOUNT 

6.2 

M.MOUNT 

7.2 

M.DMOUNT 

6.2 

M.DISMOUNT 

7.2 

M.MEMB 

6.2 

M.GETMEMBYTES 

7.2 



System Services Cross-Reference 



SVC Listing 


Volume I 

SVC 

2,XVm’ Description 

4C Free Memory in 

Byte Increments 

4D-4E Reserved 

4F Reserved 

50 Acquire Current 

Date/Time in 
ASCII Format 
Acquire Current 
Date/Time in 
Binary Format 
Acquire Current 
Date/Time in 
Byte Binary For 
Acquire System 
Date/Time in 
Any Format 
Get Current 
Date and Time 


Convert ASCII 

H.REXS/75 

M.CONABB 

6.2 

Date/Time to 


M_CONABB 

7.2 

Byte Binary Format 

Convert ASCII 

H.REXS/75 

M.CONASB 

6.2 

Date/Time to 


M_CONASB 

7.2 

Standard Binary 

Convert Binary 

H.REXS/75 

M.CONBAF 

6.2 

Date/Time to 


M_CONBAF 

7.2 

ASCII Format 

Convert Binary 

H.REXS/75 

M.CONBBY 

6.2 

Date/Time to 


M_CONBBY 

7.2 

Byte Binary 

Convert Byte 

H.REXS/75 

M.CONBBA 

6.2 

Binary Date/Time 


M_CONBBA 

7.2 

to ASCII 

Convert Byte 

H.REXS/75 

M.CONBYB 

6.2 

Binary Date/Time 


M_CONBYB 

7.2 

to Binary 

Convert System 

H.REXS/75 

M.CTIM 

6.2 

Date/Time Format 


M_CTIM 

7.2 

Convert Time 

H.REXS/75 

M_CONVERTTIME 

7.2 

Assign and 

H.REXS.21 

M.ASSN 

6.2 

Allocate Resource 


M_ASSIGN 

7.2 


Module, 


Ref.Manual 

E.P. 

Macro 

Section 

H.REMM,29 

M.MEMFRE 

6.2 


MJFREEMEMBYTES 

7.2 


H.REXS/74 

M.QATIM 

6.2 


M_QATIM 

7.2 

H.REXS.74 

M.BTIM 

6.2 


m_btim 

7.2 

H.REXS.74 

M.BBTIM 

6.2 


m_bbtim 

7.2 

H.REXS.74 

M.GTIM 

6.2 


M_GTIM 

7.2 

H.REXS/74 

M_GETTIME 

7.2 
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SVC Listing 


Volume I 


SVC 


Module, 


Ref.Manual 

2,X’nn' 

Description 

E.P. 

Macro 

Section 

53 

Deassign and 

H.REXS.22 

M.DASN 

6.2 


Deallocate Resource 


M_DEASSIGN 

7.2 

54 

Reformat RRS 
Entry 

H.REXS.76 

M.NEWRRS 

6.2 

55 

Batch Job Entry 

H.REXS.27 

M.BATCH 

6.2 




M_BATCH 

7.2 

56 

Reserved for 
Interactive Debugger 

H.REXS.30 

N/A 

N/A 

57 

Reinstate 

H.REXS.78 

M.PRIV 

6.2 


Privilege Mode 
to Privilege Task 


M_PRIVMODE 

7.2 

58 

Change Task to 

H.REXS.79 

M.UPRIV 

6.2 


Unprivileged Mode 


M_UNPRIVMODE 

7.2 

59 

Validate Address 

H.REXS.33 

M.VADDR 

6.2 


Range 


M_VADDR 

7.2 

5A 

Reserved 




5B 

Set IPU Bias 

H.REXS.82 

M.IPUBS 

6.2 




M_EPUBS 

7.2 

5C 

Set Exception 
Handler 

H.REXS.83 

M_SETEXA 

7.2 

5D 

Get Base Mode 
Task Address Limits 

H.REXS.84 

M.LIMITS 

7.2 

5E 

Get Task 

H.REXS.85 

M.ENVRMT 

6.2 


Environment 


m_envrmt 

7.2 

5F 

Exit With Status 

H.REXS.86 

M_EXTSTS 

7.2 

60 

Reserved 




61 

Get Command Line 

H.REXS.88 

M.CMD 

6.2 




M_CMD 

7.2 

62 

Move Data to 

H.REXS.89 

M.MOVE 

6.2 


User Address 


M_MOVE 

7.2 

63-6F 

Reserved 




70 

Get User Context 

H.EXEC.41 

M_GETCTX 

7.2 

71 

Put User Context 

H.EXEC,42 

M_PUTCTX 

7.2 

72-74 

Reserved for Symbolic 
Debugger/X32 




75 

Reserved for MPX-32 
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SVC Listing 






Volume I 

SVC 


Module, 


Ref.Manual 

2,X’nn’ 

Description 

E.P. 

Macro 

Section 

76 

Allocate Shadow Memory 

H.SHAD 

N/A 

N/A 

77 

Set Option Lower 

H.TSM.13 

M.SOPL 

6.2 




M_SOPL 

7.2 

78 

Reset Option Lower 

H.TSM.14 

M.ROPL 

6.2 




M_ROPL 

7.2 

79 

Set Exception 
Return Address 

H.REXS.81 

M_SETERA 

7.2 

7A 

Get Terminal 

H.TSM.15 

M.GETDEF 

6.2 


Function Definition 


M_GETDEF 

7.2 

7B 

Get Address Limits 

H.REXS,80 

M.GADRL2 

6.2 

7C 

Get Dynamic 
Extended Discontiguous 
Data Space 

H.MEMM.9 

M.GDD 

6.2 

7D 

Get TSA Start 

H.REXS.91 

M.GTSAD 

6.2 


Address 


M_GTSAD 

7.2 

7E 

Physical Memory Read 

H.REXS.93 

M.OSREAD 

6.2 




M_OSREAD 

7.2 

7F 

Get Extended 
Memory Array 

H.MEMM,14 

N/A 

6.3 


Get Extended 
Memory Array - 
Base Mode 

H.MEMM.14 

N/A 

7.3 

80-9F 

Reserved for ACX-32 




AO- A3 

Reserved for Swapper 




A4-A9 

Reserved for Ada 




AA-AD 

Reserved for Rapid 
File Allocation: 


N/A 

N/A 


Zero MDT 

H.MDT.1 




Locate/Read MDT Entry 

H.MDT.2 




Update/Create MDT 
Entry 

H.MDT,3 




Delete MDT Entry 

H.MDT.4 



AE 

TSM Procedure Call 

H.TSM.17 

M.TSMPC 

6.2 




M_TSMPC 

7.2 

AF 

Physical Memory Write 

H.REXS,94 

M.OSWRIT 

6.2 




M_OSWRIT 

7.2 

BO-BE 

Reserved for RMSS 




BF 

Reserved 
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SVC Listing 


SVC 
2 ,X'nn' 

Description 

Module, 

E.P. 

Macro 

Volume I 

Ref.Manual 

Section 

CO 

Task Option 
Doubleword Inquiry 

H.REXS.95 

M.PGOD 6.2 

M_OPTIONDWORD 7.2 

C1-C7 

Reserved 




N/A 

Allocate File 
Space 

H.VOMM.19 

N/A 

6.3 

N/A 

Allocate 

Resource Descriptor 

H.VOMM.17 

N/A 

6.3 

N/A 

Create File 
Control Block 

N/A 

N/A 

M.DFCB 

M_CREATEFCB 

5.9.1 

7.2 

N/A 

Create Temporary 
File 

H.VOMM.24 

N/A 

6.3 

N/A 

Deallocate File 
Space 

H.VOMM.20 

N/A 

6.3 

N/A 

Deallocate 
Resource Descriptor 

H.VOMM.18 

N/A 

6.3 

N/A 

Execute Channel 
Program File 
Control Block 

N/A 

M_CHANPROGFCB 

7.2 

N/A 

Read/Write 
Authorization File 

H.VOMM.25 

N/A 

6.3 

SVC 

5,X’nn' 

Description 

Module, 

E.P. 

Macro 

Volume I 

Ref.Manual 

Section 

00 

Suspend/Resume 

N/A 

M.SURE 

M_SURE 

6.2 

7.2 
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0 MPX-32 Abort and Crash Codes 


( 

C.1 AC - Accounting 

AC01 INSUFFICIENT SLO SPACE FOR ACCOUNTING LISTING 

C.2 AD - Address Specification T rap Handler (H.IPOC) 

ADO 1 ADDRESS SPECIFICATION ERROR OCCURRED WITHIN THE 

OPERATING SYSTEM 

ADO 2 ADDRESS SPECIFICATION ERROR OCCURRED WITHIN THE 

CURRENT TASK 

ADO 3 TRAP OCCURRED WHILE NO TASKS WERE IN ACTIVE STATE 

ADO 4 TRAP OCCURRED WITHIN ANOTHER INTERRUPT TRAP ROUTINE 


C.3 AL - Allocator (H.ALOC) (Compatibility Mode Only) 


( 


AL01-AL06 Reserved 

AL07 THE COMBINED FILE ASSIGNMENTS FOR A TASK EXCEEDS 

NUMBER SPECIFIED. THE CATALOGED ASSIGNMENTS ARE 
COMBINED WITH THOSE DEFINED BY $ASSIGN STATEMENTS. 
SEE CATALOGER FILES DIRECTIVE AND RECATALOG IF 
NEEDED . 

AL08 AN ASSIGNED PERMANENT FILE IS NONEXISTENT 

AL09 AN ASSIGNED DEVICE IS NOT CONFIGURED IN THE SYSTEM. 

AN ASSIGNED DEVICE IS OFF-LINE. 

ALIO -ALII Reserved 

AL12 UNABLE TO LOAD PROGRAM BECAUSE OF I/O ERROR OR 

ADDRESSING INCONSISTENCIES IN LOAD MODULE PREAMBLE 

AL13 AN UNRECOVERABLE I/O ERROR HAS OCCURRED DURING THE 

READ OF THE TASK PREAMBLE INTO THE TSA 

AL14 Reserved 

AL15 AN ASSIGNED DEVICE TYPE IS NOT CONFIGURED IN THE 

SYSTEM 

AL16 A RESIDENT REQUEST HAS BEEN ISSUED FOR A TASK 

REQUIRING AN SLO, SBO, SGO OR SYC FILE. RESIDENT 
TASKS CANNOT USE SYSTEM FILES. 

AL17-AL18 Reserved 


MPX-32 Reference 
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AL - Allocator (H.ALOC) (Compatibility Mode Only) 


AL19 

AL20 

AL21 

AL22 

AL23 

AL24 

AL25 

AL26 

AL27 

AL28 

AL29 

AL30 

AL31 

AL32 

AL33 

AL34 

AL35 


A FILE CODE TO FILE CODE ASSIGNMENT (ASSIGN4 ) HAS 
BEEN MADE TO AN UNDEFINED FILE CODE. A FILE CODE 
MUST BE DEFINED BEFORE A SECOND FILE CODE CAN BE 
EQUATED BY AN ASSIGN4 . 

USER ATTEMPTED DEALLOCATION OF TSA 

DESTROYED TASK MIDL WAS DETECTED WHILE ATTEMPTING TO 
ALLOCATE DYNAMIC EXECUTION SPACE 

A SOFTWARE CHECKSUM ERROR HAS OCCURRED DURING TASK 
LOADING 

AN INVALID USER NAME IS CATALOGED WITH THE TASK. THE 
USER NAME IS NOT CONTAINED IN THE M . KEY FILE OR A 
VALID KEY IS NOT SPECIFIED. 

ACCESS TO AN ASSIGNED PERMANENT FILE IS BY PASSWORD 
ONLY, AND A VALID PASSWORD WAS NOT INCLUDED ON THE 
CATALOGED ASSIGNMENT OR JOB CONTROL STATEMENT 
ASSIGNMENT 

UNDEFINED RESOURCE REQUIREMENT SUMMARY (RRS) TYPE 
(INTERNAL FORMAT OF AN ASSIGNMENT STATEMENT IS 
WRONG) 

THE TASK HAS REQUESTED MORE BLOCKING BUFFERS THAN 
WERE SPECIFIED DURING CATALOG. SEE CATALOGER BUFFER 
DIRECTIVE AND RECATALOG IF NEEDED. 

THERE ARE NO FREE ENTRIES IN SHARED MEMORY TABLE FOR 
GLOBAL, DATAPOOL, CSECT, OR OTHER SHARED AREAS 

TASK IS ATTEMPTING TO SHARE AN UNDEFINED GLOBAL OR 
DATAPOOL MEMORY PARTITION 

TASK IS ATTEMPTING TO EXCLUDE UNDEFINED MEMORY 
PARTITION 

THE REQUESTED DEVICE IS ALREADY ASSIGNED TO THE 
REQUESTING TASK VIA ANOTHER FILE CODE. USE ASSIGN4 
OR DEALLOCATE BEFORE REALLOCATING. 

LOGICAL FILE CODE ALREADY ALLOCATED BY CALLER (E.G., 
A CARD READER MAY BE ASSIGNED TO LFC ' IN' AND A 
MAGNETIC TAPE CANNOT BE ASSIGNED TO THE SAME FILE 
CODE) . USE ASSIGN4 OR DEALLOCATE BEFORE 
REALLOCATING. 

DYNAMIC COMMON BLOCK MAY NOT BE ASSIGNED VIA ASSIGN1 
DIRECTIVE 

SHARED MEMORY DEFINITION CONFLICTS WITH CALLER'S 
ADDRESS SPACE 

SHARED MEMORY PARTITION NOT DEFINED IN DIRECTORY 

ATTEMPT TO SHARE A DIRECTORY ENTRY THAT IS NOT A 
MEMORY PARTITION 
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AL - Allocator (H.ALOC) (Compatibility Mode Only) 


AL36 

AL37 

AL38 

AL3 9 
AL4 0 
AL4 1 
AL42 
AL43 

AL44 
AL45 
AL4 6 
AL4 7 
AL48 

AL4 9 
AL50 

AL51 

AL52 

AL53 

AL54 

AL55 

MPX-32 Reference 


INVALID PASSWORD SPECIFIED FOR SHARED MEMORY 
PARTITION 

ATTEMPT TO EXCLUDE UNDEFINED SHARED MEMORY PARTITION 

ATTEMPT TO ACTIVATE A PRIVILEGED TASK BY 
UNAUTHORIZED OWNER 

SHARED MEMORY ENTRY NOT FOUND 

PARTITION DEFINITION NOT FOUND IN DIRECTORY 

DIRECTORY DEFINITION NOT A DYNAMIC PARTITION 

INVALID PASSWORD FOR A MEMORY PARTITION 

TASK HAS ATTEMPTED TO ALLOCATE AN UNSHARED RESOURCE 
THAT WAS NOT AVAILABLE DURING TASK ACTIVATION IN A 
MEMORY-ONLY ENVIRONMENT 

UNABLE TO RESUME 'SYSBUILD' TASK DURING INITIAL TASK 
ACTIVATION IN A MEMORY-ONLY ENVIRONMENT 

UNABLE TO DEALLOCATE INPUT DEVICE AFTER DYNAMIC TASK 
ACTIVATION IN A MEMORY-ONLY ENVIRONMENT 

TASK HAS ATTEMPTED TO SHARE MEMORY VIA A DYNAMIC 
MEMORY PARTITION IN A MEMORY-ONLY ENVIRONMENT 

DYNAMIC MEMORY PARTITIONS CANNOT BE GREATER THAN 1 
MEGABYTE 

THE USER HAS ATTEMPTED TO EXCLUDE A SHARED PARTITION 
WHOSE ASSOCIATED MAP BLOCKS ARE NOT DESIGNATED AS 
BEING SHARED IN THE TASK'S TSA 

THE TASK'S DSECT SPACE REQUIREMENTS OVERLAP THE 
TASK'S TSA SPACE REQUIREMENTS 

THE TASK'S DSECT SPACE REQUIREMENTS OVERLAP THE 
TASK'S CSECT SPACE REQUIREMENTS, OR IF NO CSECT, 

LOAD MODULE IS TOO LARGE TO FIT IN USER'S ADDRESS 
SPACE 

DESTROYED TASK MIDL DETECTED WHILE ATTEMPTING TO 
ALLOCATE SYSTEM BUFFER SPACE 

AN ERROR CONDITION PERTAINING TO FILE SYSTEM 
STRUCTURES HAS OCCURRED. THIS ERROR IS NOT A 
FUNCTION OF THE COMPATIBILITY INTERFACE. 

DESTROYED TASK MIDL WAS DETECTED WHILE ATTEMPTING TO 
ALLOCATE EXTENDED INDEXED DATA SPACE 

INVALID COMPATIBLE FIRS TYPE 

ACCESS MODE IS NOT ALLOWED 


C-3 



AT - ANSI Labeled Tapes 


C.4 AT - ANSI Labeled Tapes 

ATOl INCORRECT OR NO RUN PARAMETERS RECEIVED 

AT02 INCORRECT STATUS RETURNED FROM J.ATAPE RUN REQUEST 

AT 03 AN ERROR OCCURRED 

AT04 I/O ERROR OCCURRED ON TAPE 

C.5 AU - Auto-Start Trap Processor 

AU01 TRAP OCCURRED ON AUTO-START 

C.6 BT - Block Mode Timeout Trap 

BT01 BLOCK MODE TIMEOUT TRAP 

C.7 CM - Call Monitor Interrupt Processor (H.IP27 and H.IPOA) 

CM01 CALL MONITOR INTERRUPT PROCESSOR CANNOT LOCATE THE 

'CALM' INSTRUCTION 

CM02 EXPECTED 'CALM' INSTRUCTION DOES NOT HAVE CALM 

(X' 30' ) OPCODE 

CM03 INVALID 'CALM' NUMBER 

CM04 'CALM' NUMBER TOO LOW (OUT OF BOUNDS) 

CM05 'CALM' NUMBER TOO BIG (OUT OF BOUNDS) 

C.8 CP -Cache 

CP01 CACHE PARITY ERROR OCCURRED WITHIN THE OPERATING 

SYSTEM 

CP 02 CACHE PARITY ERROR OCCURRED IN TASK BODY 

CP03 TRAP OCCURRED WHILE NO TASKS WERE IN ACTIVE STATE 

CP04 TRAP OCCURRED IN ANOTHER INTERRUPT TRAP ROUTINE 
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EX - Exit/Abort 


C.9 EX - Exit/Abort 


EX01 AN ABORT HAS OCCURRED IN THE TASK EXIT SEQUENCE 

EX02 AN ABORT HAS OCCURRED DURING THE TASK ABORT SEQUENCE 

AND HAS BEEN CHANGED TO A DELETE (KILL) TASK 
SEQUENCE 

EX03 USER ATTEMPTED TO GO TO AN ANY WAIT STATE FROM AN 

END-ACTION ROUTINE 


C.1 0 FS - File System (H.MONS)(Compatibility Mode Only) 

FS01 UNRECOVERABLE I/O ERROR TO THE DIRECTORY 

FS02 UNRECOVERABLE I/O ERROR TO FILE SPACE ALLOCATION MAP 

FS03 ATTEMPT TO ADD A NEW FILE, BUT THE DIRECTORY IS FULL 

FS04 A DISC ALLOCATION MAP CHECKSUM ERROR WAS DETECTED 

FS05 ATTEMPT TO ALLOCATE DISC SPACE THAT IS ALREADY 

ALLOCATED 

FSO 6 ATTEMPT TO DEALLOCATE DISC SPACE THAT IS NOT 

ALLOCATED 

FSO 7 USER HAS CALLED AN ENTRY POINT IN H.FISE THAT NO 

LONGER EXISTS 

C.1 1 HE - Online Help Facility 

HE01 ABNORMAL TERMINATION WHILE TRANSLATING HELP FILES 

(HELPT) 

C.1 2 HT - Halt Trap Processor (H.IPHT) 

HT01 AN ATTEMPT WAS MADE TO EXECUTE A HALT INSTRUCTION IN 

USER'S PROGRAM 

HT02 AN ATTEMPT WAS MADE TO EXECUTE A HALT INSTRUCTION IN 

AN INTERRUPT TRAP ROUTINE 

HT03 AN ATTEMPT WAS MADE TO EXECUTE A HALT INSTRUCTION 

WHEN NO TASKS WERE IN AN ACTIVE STATE 

HT04 Reserved 

HT05 AN ATTEMPT WAS MADE TO EXECUTE A HALT INSTRUCTION 

WHEN USER WAS UNMAPPED 
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HT- Halt Trap Processor (H.IPHT) 


C.1 3 10 - Input/Output Control Supervisor (H.IOCS) 

10 01 Reserved 

1002 AN UNPRIVILEGED TASK IS ATTEMPTING TO READ OR WRITE 

DATA INTO AN UNMAPPED ADDRESS 

1003 AN UNPRIVILEGED TASK IS ATTEMPTING TO READ DATA INTO 
PROTECTED MEMORY 

1004-1005 Reserved 

1006 INVALID BLOCKING BUFFER CONTROL CELLS IN BLOCKED 

FILE ENCOUNTERED. PROBABLE CAUSES: (1) FILE IS 

IMPROPERLY BLOCKED, (2) BLOCKING BUFFER IS 
DESTROYED, OR (3) TRANSFER ERROR DURING FILE INPUT. 

1007 THE TASK HAS ATTEMPTED TO PERFORM AN OPERATION WHICH 
IS NOT VALID FOR THE DEVICE TO WHICH THE USER'S FILE 
IS ASSIGNED (E.G. , A READ OPERATION SPECIFIED FOR A 
FILE ASSIGNED TO THE LINE PRINTER) . 

1008 DEVICE ASSIGNMENT IS REQUIRED FOR AN UNPRIVILEGED 
TASK TO USE THIS SERVICE 

1009 ILLEGAL OPERATION ON THE SYC FILE 
1010-1014 Reserved 

1015 A TASK HAS REQUESTED A TYPE OPERATION AND THE TYPE 
CONTROL PARAMETER BLOCK (TCPB) SPECIFIED INDICATES 
THAT AN OPERATION ASSOCIATED WITH THAT TCPB IS 
ALREADY IN PROGRESS 

1016 INVALID BLOCKING BUFFER CONTROL CELL(S) ENCOUNTERED 
DURING WRITE OF BLOCKED FILE. THIS ERROR IS USUALLY 
CAUSED BY A USER SPECIFIED BLOCKING BUFFER THAT HAS 
BEEN DESTROYED. 

1017 OPEN ATTEMPTED ON A FILE AND FPT HAS NO MATCHING 

FILE CODE. PROBABLE CAUSE: (1) BAD OR MISSING RRS IN 

PREAMBLE (2) LFC IN FCB HAS BEEN DESTROYED. 

1018 Reserved 

1019 AN ERROR HAS OCCURRED IN THE REMM CLOSE PROCEDURE 

1020 AN ERROR HAS OCCURRED IN THE REMM OPEN PROCEDURE 

1021 IOCS HAS ENCOUNTERED AN UNRECOVERABLE I/O ERROR IN 

ATTEMPTING TO PROCESS AN I/O REQUEST ON BEHALF OF A 
TASK 

1022 AN ILLEGAL IOCS ENTRY POINT HAS BEEN ENTERED BY A 
TASK 

1023 A H.VOMM DENIAL HAS OCCURRED IN READING THE RESOURCE 
DESCRIPTOR TO GET MORE SEGMENT DEFINITIONS 
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10 - Input/Output Control Supervisor (H.IOCS) 


1024 

1025-1027 

1028 

1029 

1030 

1031 

1032 

1033 

1034 

1035 

1036-1037 

1038 

1039 
104 0 


1041 

1042 

1043 

1044 

1045 

1046 

1047 


ILLEGAL ADDRESS, TRANSFER COUNT OR TRANSFER TYPE 
( I . E . , IMPROPER BOUNDING FOR DATA TYPE) SPECIFIED IN 
THE FCB 

Reserved 

ILLEGAL OPERATION ATTEMPTED ON AN OUTPUT ACTIVE FILE 
OR DEVICE 

Reserved 

ILLEGAL OR UNEXPECTED VOLUME NUMBER OR REEL ID 
ENCOUNTERED ON MAGNETIC TAPE 

Reserved 

CALLING TASK HAS ATTEMPTED TO PERFORM A SECOND READ 
ON A '$' STATEMENT THROUGH THE SYC FILE 

READ WITH BYTE GRANULARITY REQUEST MADE WITH 
NEGATIVE BYTE OFFSET 

READ WITH BYTE GRANULARITY REQUEST MADE WITHOUT 
SETTING RANDOM ACCESS BIT IN FCB 

READ WITH BYTE GRANULARITY REQUESTS ARE VALID FOR 
UNBLOCKED FILES ONLY 

Reserved 

WRITE ATTEMPTED ON UNIT OPENED IN READ-ONLY MODE. A 
READ-WRITE OPEN WILL BE FORCED TO READ-ONLY IF TASK 
HAS ONLY READ ACCESS TO UNIT. 

Reserved 

INVALID TRANSFER COUNT. TRANSFER COUNT TOO LARGE 
FOR TRANSFER TYPE, TRANSFER COUNT NOT AN EVEN 
MULTIPLE OF TRANSFER TYPE, OR DATA ADDRESS NOT 
BOUNDED FOR TRANSFER TYPE. 

BLOCKING ERROR DURING NON-DEVICE ACCESS 

BLOCKED DATA MANAGEMENT MODULE (H.BKDM) IS NOT 
CONFIGURED IN THE SYSTEM 

INPUT/OUTPUT CONTROL LIST (IOCL) OR DATA ADDRESS NOT 
IN CONTIGUOUS ' E' MEMORY (GPMC DEVICES ONLY) 

NON-DEVICE ACCESS I/O ERROR. THIS ERROR MAY BE THE 
RESULT OF CHANNEL/CONTROLLER INITIALIZATION FAILURE. 

MULTIVOLUME MAGNETIC TAPE MODULE (H.MVMT) IS NOT 
CONFIGURED IN THE SYSTEM 

Reserved 

CLASS 'E' DEVICE TCW IS NOT IN CLASS ' E' MEMORY. 

THIS TYPE OF ERROR INDICATES A MAP FAILURE. 
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10 - Input/Output Control Supervisor (H.IOCS) 


1048 

1050 

1051 

1052 

1053 

1054 

1055 

1056 

1057 

1058- 

1061 

1062 

1063- 

1077 

1078 

1079 

1080 
1081- 

1098 

1099 


-104 9 Reserved 

AN UNPRIVILEGED USER ATTEMPTED TO EXECUTE A PHYSICAL 
CHANNEL PROGRAM 

A 'TESTSTAR' COMMAND WAS USED IN A LOGICAL CHANNEL 
PROGRAM 

A LOGICAL CHANNEL WAS TOO LARGE TO BE MOVED TO 
MEMORY POOL 

A 'TIC' COMMAND FOLLOWS A 'TIC' COMMAND IN A LOGICAL 
CHANNEL PROGRAM 

A 'TIC' COMMAND ATTEMPTED TO TRANSFER TO AN ADDRESS 
WHICH IS NOT WORD BOUNDED 

ILLEGAL ADDRESS IN LOGICAL IOCL . ADDRESS IS NOT IN 
USER'S LOGICAL ADDRESS SPACE. 

A READ-BACKWARD COMMAND WAS USED IN A LOGICAL 
CHANNEL PROGRAM 

ILLEGAL IOCL ADDRESS. IOCL MUST BE LOCATED IN THE 
FIRST 12 8K WORDS OF MEMORY. 

1060 Reserved 

INVALID LFC IN FCB 

ERROR OCCURRED ON IMPLICIT OPEN 

107 6 Reserved 

ATTEMPT TO USE DATA FLOW CONTROL (OTHER THAN WISM) , 
THAT IS NOT SUPPORTED BY THE CURRENTLY INSTALLED 
CONTROLLER 

ATTEMPT TO ISSUE AN EXECUTE CHANNEL PROGRAM TO A 
WRITE SUB-CHANNEL AND THE SUB-CHANNEL WAS NOT IN 
DUAL CHANNEL MODE 

Reserved 

ILLEGAL ACCESS MODE FOR VOLUME RESOURCE 

1097 Reserved 

H.VOMM DENIAL HAS OCCURRED ON IOCS AUTOMATIC FILE 
EXTENSION REQUEST FOR THE LFC SPECIFIED IN THE ABORT 
MESSAGE 

INTERNAL SYSTEM ERROR DETECTED AT THE ADDRESS 
RELATIVE TO IOCS WHICH IS SPECIFIED IN THE ABORT 
MESSAGE 
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IP-IPU 


C.14 IP-IPU 

IPOl ABNORMAL TASK TERMINATION IN IPU 

C.1 5 LD - Task Activation Loading (H.TAMM) 


LD01 

LOAD 

CODE SECTION ERROR 

LD02 

CODE 

SECTION CHECKSUM ERROR 

LD03 

BIAS 

CODE ERROR 

LD04 

CODE 

MATRIX CHECKSUM ERROR 

LD05 

LOAD 

DATA SECTION ERROR 

LD06 

DATA 

SECTION CHECKSUM ERROR 

LD07 

BIAS 

DATA ERROR 

LD08 

DATA 

MATRIX CHECKSUM ERROR 

LD09 

GCF R/O RELOCATION ERROR 

LD10 

GCF R/W RELOCATION ERROR 


C.1 6 MC - Machine Check Trap 

MC01 MACHINE CHECK TRAP 


C.1 7 MF - Map Fault T rap 

MF01 A MAP FAULT TRAP HAS OCCURRED. THIS IS THE RESULT OF 

A BAD MEMORY REFERENCE OUTSIDE OF THE USER'S 
ADDRESSABLE SPACE. 

C.1 8 MM - Memory Disk 

MM01 REQUEST FOR MEMORY DISC I/O TO A LOCATION OUTSIDE 

THE MEMORY DISC BOUNDARIES 
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MP - Memory Parity Trap (H.IP02) 

C.19 MP - Memory Parity Trap (H.IP02) 

MP01 MEMORY ERROR OCCURRED IN A TASK'S LOGICAL ADDRESS 

SPACE. THIS IS AN INTERNAL OR CPU FAILURE. RERUN 
TASK. 

MP02 MEMORY ERROR OCCURRED IN ANOTHER INTERRUPT TRAP 

ROUTINE (NESTED TRAPS, CONTEXT LOST) 

MP03 MEMORY ERROR OCCURRED WHILE NO TASKS WERE IN THE 

ACTIVE STATE 

MP04 MEMORY ERROR OCCURRED IN A MAP BLOCK RESERVED FOR 

THE O/S 

MP05 ERROR OCCURRED WHILE CURRENT TASK WAS IN THE 

UNMAPPED MODE 

C.20 MS - System Services (H.MONS) (Compatibility Mode Only) 

MS 01 PERMANENT FILE ADDRESS INQUIRY SERVICE FOUND A 

NUMBER OF ALLOCATION UNITS IN THE UNIT DEFINITION 
TABLE THAT DO NOT CORRESPOND TO ANY KNOWN DISC. 

MS 02 -MS 08 Reserved 

MS 09 v 

TASK HAS ATTEMPTED TO CONNECT A TASK TO AN INTERRUPT 
LEVEL NOT DEFINED FOR INDIRECTLY CONNECTED TASKS 

MS 10 -MS 11 Reserved 

MS 12 OVERLAY IS PASSWORD PROTECTED 

MS 13 -MS 15 Reserved 

MSI 6 TASK HAS REQUESTED DYNAMIC ALLOCATION WITH AN 

INVALID FUNCTION CODE 

MS17 FILE NAME CONTAINS CHARACTERS OUTSIDE RANGE OF X'20' 

TO X'5F', INCLUSIVELY 

MS 18 -MS 20 Reserved 

MS21 MULTIVOLUME MAGNETIC TAPE ALLOCATION REQUEST MADE TO 

SCRATCH (SCRA) TAPE 

MS22 MULTI-VOLUME MAGNETIC TAPE ALLOCATION REQUEST MADE 

ON SHARED TAPE DRIVE 

MS23 TASK HAS ISSUED A 'MOUNT MESSAGE ONLY' ALLOCATION 

REQUEST TO A NON-ALLOCATED DRIVE OR TO A DEVICE 
WHICH IS NOT A MAGNETIC TAPE 
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MS - System Services (H.MONS) (Compatibility Mode Only) 


MS24 TASK HAS SPECIFIED AN ILLEGAL VOLUME NUMBER (ZERO IF 

TAPE IS MULTIVOLUME, NONZERO IF TAPE IS SINGLE 
VOLUME) 

MS 2 5 -MS 2 7 Reserved 

MS28 A PERMANENT FILE LOG HAS BEEN REQUESTED, BUT THE 

ADDRESS SPECIFIED FOR STORAGE OF THE DIRECTORY ENTRY 
IS NOT CONTAINED WITHIN THE CALLING TASK'S LOGICAL 
ADDRESS SPACE 

MS 2 9 Reserved 

MS30 TASK HAS ATTEMPTED TO OBTAIN A PERMANENT FILE LOG IN 

A MEMORY-ONLY ENVIRONMENT 

MS31 USER ATTEMPTED TO GO TO THE ANY-WAIT STATE FROM AN 

END-ACTION ROUTINE 

MS 3 2 Reserved 

MS 3 3 ALLOCATION ERROR IN RTM M.ALOC CALL 

MS34-MS86 Reserved 

MS87 NO DENIAL RETURN ADDRESS SPECIFIED ON CALM M.ALOC 

EMULATION 


C.21 NM - Nonpresent Memory Trap 


NM01 A NONPRESENT MEMORY TRAP ERROR CONDITION HAS 

OCCURRED . 


C.22 OC - Operator Communications 

OCOl THE OPERATOR HAS REQUESTED THAT THE TASK BE ABORTED 

C.23 PT - Task Activation (J.TSM) 

PT01 INVALID ATTEMPT TO MULTICOPY A UNIQUE TASK 

PT02 FILE SPECIFIED IS NOT IN DIRECTORY 

PT03 UNABLE TO ALLOCATE FILE 

PT04 FILE IS NOT A VALID LOAD MODULE OR EXECUTABLE IMAGE 

PT05 DQE IS NOT AVAILABLE 

PT06 READ ERROR ON RESOURCE DESCRIPTOR 
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PT - Task Activation (J.TSM) 


PT07 READ ERROR ON LOAD MODULE 

PT08 INSUFFICIENT LOGICAL/PHYSICAL ADDRESS SPACE FOR TASK 

ACTIVATION 

PT09 CALLING TASK IS UNPRIVILEGED 

PT10 INVALID PRIORITY 

PT11 INVALID SEND BUFFER ADDRESS OR SIZE 

PT12 INVALID RETURN BUFFER ADDRESS OR SIZE 

PT13 INVALID NO-WAIT MODE END ACTION ROUTINE ADDRESS 

PT14 MEMORY POOL UNAVAILABLE 

PT15 DESTINATION TASK RECEIVER QUEUE FULL 

PT16 INVALID PSB ADDRESS 

PT17 RRS LIST EXCEEDS 384 WORDS 

PT18 INVALID RRS ENTRY IN PARAMETER BLOCK 

C.24 PV - Privilege Violation Trap 

PV01 PRIVILEGE VIOLATION TRAP 

C.25 RC - Record Manager 

RC01 LESS THAN ONE BLOCK ON READ 

RC02 NOT A MULTIPLE NUMBER OF BLOCKS READ 

RC03 NO MORE IOC'S AVAILABLE 

RC04 ERROR CONDITION ON READ 

RC05 PREMATURE END-OF-FILE 

RC06 END-OF -MEDIUM ON OUTPUT FILE 

RC07 WRITE ATTEMPTED ON UNOPENED FILE 

RC08 USER RECORD SIZE TOO LARGE 

RC09 READ NOT ALLOWED AFTER WRITE 

RC10 ERROR ON WRITE 

RC11 END-OF -MEDIUM ON OUTPUT FILE 
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RC - Record Manager 


RC12 INTERNAL FILE POSITION ERROR 

RC13 RESOURCE CANNOT BE OPENED 

RC14 INTERNAL FILE POSITION ERROR 

RC15 INVALID BLOCKING BUFFER CELL 

C.26 RE - Restart 

RE01 RESTART IS INVALID IN BATCH OR COMMAND FILE MODE 

C.27 RF - Rapid File Allocation 

RF01 INVALID PATHNAME 

RF02 PATHNAME CONSISTS OF VOLUME ONLY 

RF03 VOLUME NOT MOUNTED 

RF04 Reserved 

RF05 FILE IS NOT A PERMANENT FILE 

RF06 Reserved 

RF07 RESOURCE DOES NOT EXIST 

RF08 RESOURCE NAME IN USE 

RF09 Reserved 

RF10 MDT ENTRY UNAVAILABLE 

RF11-RF14 Reserved 

RF15 VOLUME MUST BE MOUNTED PUBLIC 

RF16-RF59 Reserved 
RF60 INVALID MODE 

RF61-RF98 Reserved 

RF99 WARNING, INPUT ERRORS ENCOUNTERED, CHECK SLO OUTPUT 

C.28 RM - Resource Management (H.REMM) 

RM01 UNABLE TO LOCATE RESOURCE 

RM02 ACCESS MODE NOT ALLOWED 
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RM - Resource Management (H.REMM) 


RM03 

RM04 

RM05 
RM06 
RM07 
RM08 
RM09 
RM10 
RM11 
RM12 
RM13 
RM14 
RM15 
RM16 
RM17 
RM18 
RM1 9 
RM20 
RM21 
RM22 
RM23 
RM24 
RM25 
RM2 6 
RM27 
RM28 
RM29 

RM30 


TOO MANY ASSIGNMENTS 

BLOCKING BUFFER SPACE NOT AVAILABLE OR INVALID 
BUFFER ADDRESS 

SHARED MEMORY TABLE (SMT) ENTRY NOT FOUND 

TOO MANY MOUNT REQUESTS 

STATIC ASSIGN TO DYNAMIC COMMON 

UNRECOVERABLE I/O ERROR 

INVALID USAGE SPECIFICATION 

INVALID PARAMETER ADDRESS 

INVALID RESOURCE REQUIREMENT SUMMARY (RRS) ENTRY 

INVALID LFC TO LFC ASSIGNMENT 

DEVICE NOT IN SYSTEM OR OFF-LINE 

RESOURCE ALREADY ALLOCATED BY TASK 

INVALID SYC/SGO ASSIGNMENT 

COMMON CONFLICTS WITH TASK ADDRESS SPACE 

DUPLICATE LFC ASSIGNMENT 

INVALID DEVICE SPECIFICATION 

INVALID RESOURCE ID (RID) 

VOLUME UNASSIGNED OR ACCESS NOT ALLOWED 

UNABLE TO MOUNT. J. MOUNT RUN REQUEST FAILED 

RESOURCE MARKED FOR DELETION 

ASSIGNED DEVICE IS MARKED OFF-LINE 

UNABLE TO LOCATE MOUNTED VOLUME TABLE (MVT) ENTRY 

RANDOM ACCESS NOT ALLOWED 

ATTEMPT TO WRITE ON SYC 

RESOURCE ALREADY OPENED IN DIFFERENT MODE 

INVALID ACCESS SPECIFICATION AT OPEN 

INVALID FILE CONTROL BLOCK (FCB) ADDRESS OR 
UNASSIGNED LFC IN FCB 

INVALID ALLOCATION INDEX 
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RM - Resource Management (H.REMM) 


RM31 

RM32 

RM33 

RM34 

RM35 
RM36 
RM37 
RM38 
RM39 
RM4 0 
RM4 1 
RM42 
RM43 
RM4 4 

RM4 5 

RM4 6 

RM47 

RM48 

RM49 

RM50 

RM51 

RM52 

RM53 

RM54 

RM55 


RESOURCE NOT OPEN 

LOCK NOT OWNED BY THIS TASK 

RESOURCE IS NOT ALLOCATED IN A SHARABLE MODE 

SYSTEM ADMINISTRATOR ATTRIBUTE IS REQUIRED TO MOUNT 
A PUBLIC VOLUME 

RESOURCE IS NOT A SHARED IMAGE 

PHYSICAL MEMORY ALREADY ALLOCATED 

ATTEMPT TO ALLOCATE NONPRESENT PHYSICAL MEMORY 

TIME OUT WAITING FOR RESOURCE 

UNABLE TO PERFORM WRITE BACK 

INVALID LOAD MODULE 

INVALID PHYSICAL ADDRESS SPECIFIED 

USER REQUESTED ABORT OF MOUNT PROCESS 

USER REQUESTED HOLD ON MOUNT PROCESS 

WRITEBACK REQUESTED AND SHARED IMAGE HAS NO 
WRITEBACK SECTION 

LOADING ERROR DURING INCLUSION OF READ ONLY SECTION 
OF SHARED IMAGE 

UNABLE TO OBTAIN RESOURCE DESCRIPTOR LOCK (MULTIPORT 
ONLY) 

LOADING ERROR DURING INCLUSION OF READ/WRITE SECTION 
OF SHARED IMAGE 

INCOMPATIBLE LOAD ADDRESSES FOR SHARED IMAGE 

TASK HAS REQUESTED EXCESSIVE NUMBER OF MULTICOPIED 
SHARED IMAGES WITH NO READ ONLY SECTION 

RESOURCE IS LOCKED BY ANOTHER TASK 

SHAREABLE RESOURCE IS ALLOCATED BY ANOTHER TASK IN 
AN INCOMPATIBLE ACCESS MODE 

VOLUME SPACE IS NOT AVAILABLE 

ASSIGNED DEVICE IS NOT AVAILABLE 

UNABLE TO ALLOCATE RESOURCE FOR SPECIFIED USAGE 

ALLOCATED RESOURCE TABLE (ART) SPACE IS NOT 
AVAILABLE 
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RM - Resource Management (H.REMM) 


RM56 
RM5 7 

RM58 
RM5 9 
RM60 
RM61 
RM62 
RM63 
RM64 

RM65 

RM66 

RM67 

RM68 

RM69 

RM70 

RM71 

RM72 

RM73 

RM74 
RM75 
RM7 6 
RM77 

RM78 
RM7 9 
RM80 


TASK REQUIRES SHADOW MEMORY AND NONE IS CONFIGURED 

VOLUME IS NOT AVAILABLE FOR MOUNT WITH REQUESTED 
USAGE 

SHARED MEMORY TABLE (SMT) SPACE IS NOT AVAILABLE 

MOUNTED VOLUME TABLE (MVT) SPACE IS NOT AVAILABLE 

RESOURCE DESCRIPTOR SPACE DEFINITION CONFLICT 

UNABLE TO LOCATE OR RETRIEVE RESOURCE DESCRIPTOR 

INVALID OPTION IN CNP 

SEGMENTED TASK SUPPORT NOT PRESENT. 

THE TASK'S DSECT SPACE REQUIREMENTS OVERLAP THE 
TASK'S TASK SERVICE AREA (TSA) SPACE REQUIREMENTS 

THE TASK' S DSECT SPACE REQUIREMENTS OVERLAP THE 
TASK'S CSECT SPACE REQUIREMENTS, OR IF NO CSECT, 
LOAD MODULE IS TOO LARGE TO FIT IN USER'S ADDRESS 
SPACE 

SOFTWARE CHECKSUM. ERROR MAY BE FIXED BY 
RECATALOGING . 

EXCESSIVE MEMORY REQUEST 

EXCESSIVE VOLUME SPACE REQUESTED 

INVALID USERNAME SPECIFIED 

INVALID PRIVILEGED ACTIVATION 

Reserved 

UNABLE TO RESUME SYSINIT ON TAPE ACTIVATION 

FILE OVERLAP HAS OCCURRED. PLEASE CHECK THE SYSTEM 
CONSOLE 

LOADING ERROR 

INVALID WORK VOLUME/DIRECTORY 
USER ATTEMPTED DEALLOCATION OF TSA 

A TASK HAS DESTROYED THE ALLOCATION LINKAGES IN ITS 
DYNAMIC EXPANSION SPACE 

UNABLE TO LOAD TASK DEBUGGER WITH TASK 

INVALID CALLER NOTIFICATION PACKET (CNP) ADDRESS 

SHARED IMAGE VERSION LEVEL IS NOT COMPATIBLE WITH 
EXECUTABLE IMAGE 
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RM - Resource Management (H.REMM) 


RM81 INVALID ACTIVATION OF A BASE MODE TASK ON A SYSTEM 

CONFIGURED FOR NON-BASE TASK EXECUTION. 

RM82 INVALID ACTIVATION OF AN ADA TASK ON A SYSTEM 

CONFIGURED WITHOUT ADA SUPPORT. 

RM83 INSUFFICIENT LOGICAL ADDRESS SPACE TO ACTIVATE TASK 

RM84 INVALID LOGICAL POSITION FOR EXTENDED MPX 

RM85 P TRACE DEBUG REQUESTED AND H.PTRAC NOT CONFIGURED 

RM86 CANNOT DISMOUNT THE SYSTEM VOLUME. 

RM87 PUBLIC VOLUME DISMOUNT DENIED DUE TO COMPATIBLE MODE 

PUBLIC DISMOUNT OPTION SET FOR THIS SYSTEM. 

RM88 PUBLIC DISMOUNT DENIED. SYSTEM ADMINISTRATOR 

ATTRIBUTE REQUIRED FOR THIS OPERATION. 

RM89 PUBLIC DISMOUNT DENIED DUE TO MISSING OPTION FOR 

PUBLIC VOLUME IN THE DISMOUNT REQUEST 

RM90 GCL LOADMODULE OR SHIM CANNOT BE RELOCATABLE 

RM91 UNABLE TO ACCESS VOLUME DUE TO PENDING PHYSICAL 

DISMOUNT. 

RM92 READ ONLY OR READ WRITE LOAD ADDRESS IS INVALID 

RM93 UNABLE TO PERFORM PHYSICAL MOUNT DUE TO SYSTEM 

SHUTDOWN IN PROGRESS. 

RM94 J. MOUNT ATTEMPTED TO MOUNT AN UNFORMATTED DISC 

VOLUME . 

RM95 AN UNBIASED TASK REQUIRES SHADOW MEMORY ON A SYSTEM 

WITH NO OVERLAPPING CPU/IPU SHADOW REGION 

RM96 A BIASED TASK REQUIRES SHADOW MEMORY THAT DOES NOT 

EXIST ON THE SPECIFIED PROCESSOR 

RM97 Reserved 

RM98 THE TASK REQUIRES MORE SHADOW MEMORY THAN EXISTS 


C.29 RX - Resident Executive Services (H.REXS) 


RX01 Reserved 

RX02 INVALID FUNCTION CODE SPECIFIED FOR REQUEST TO 

CREATE A TIMER ENTRY. VALID CODES ARE ACP (1), RSP 
OR RST (2), STB (3), RSB (4) AND RQI (5). 

RX03 TASK ATTEMPTED TO SET/RESET A BIT OUTSIDE OF A 

STATIC PARTITION OR THE OPERATING SYSTEM. 
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RX - Resident Executive Services (H.REXS) 


RX04 

THE REQUESTING TASK IS UNPRIVILEGED OR HAS ATTEMPTED 
TO CREATE A TIMER ENTRY TO REQUEST AN INTERRUPT WITH 
A PRIORITY LEVEL OUTSIDE THE RANGE OF X' 12' TO 
X' 7F', INCLUSIVELY 

RX05 

INVALID FUNCTION CODE HAS BEEN SPECIFIED FOR REQUEST 
TO SET USER STATUS WORD 

RX06 

UNPRIVILEGED TASK ATTEMPTED TO RESET A TASK PRIORITY 
LEVEL, OR A PRIVILEGED TASK ATTEMPTED TO RESET A 
TASK PRIORITY TO A LEVEL OUTSIDE THE RANGE OF 1 TO 
64, INCLUSIVELY 

RX07 

CANNOT LOAD OVERLAY SEGMENT DUE TO SOFTWARE CHECKSUM 
OR DATA ERROR 

RX08 

OVERLAY IS NOT IN THE DIRECTORY 

RX0 9 

Reserved 

RX10 

OVERLAY HAS AN INVALID PREAMBLE 

RX11 

AN UNRECOVERABLE I/O ERROR HAS OCCURRED DURING 
OVERLAY LOADING 

RX12 

Reserved 

RX13 

FUNCTION CODE SUPPLIED TO A DATE/TIME SERVICE IS OUT 
OF RANGE 

RX14 

DESTINATION BUFFER ADDRESS IS INVALID OR PROTECTED 

RX15 

ATTEMPT TO SET EXCEPTION RETURN ADDRESS WHEN 
ARITHMETIC EXCEPTION NOT IN PROGRESS 

RX16-RX24 

Reserved 

RX25 

OPERATOR HAS ABORTED TASK IN RESPONSE TO MOUNT 
MESSAGE 

RX26-RX28 

Reserved 

RX29 

TASK HAS ATTEMPTED TO LOAD THE INTERACTIVE TASK 
DEBUGGER OVERLAY IN A MEMORY-ONLY ENVIRONMENT 

RX30-RX31 

Reserved 

RX32 

INVALID DQE ADDRESS 

RX33 

OVERLAY LINKAGES HAVE BEEN DESTROYED BY LOADING A 
LARGER OVERLAY 

RX34 

TASK HAS MADE A BREAK RECEIVER EXIT CALL WHILE NO 
BREAK IS ACTIVE 

RX35 

Reserved 
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RX - Resident Executive Services (H.REXS) 


RX36 

STATUS IN REGISTER ZERO IS NOT A ZERO OR A VALID 
ABORT CODE 

RX37-RX85 

Reserved 

RX86 

TASK HAS MADE AN END ACTION ROUTINE EXIT WHILE END 
ACTION WAS NOT ACTIVE 

RX87 

Reserved 

RX88 

RESERVED FOR DEBUG LINK SERVICE 

RX89 

AN UNPRIVILEGED TASK HAS ATTEMPTED TO REESTABLISH AN 
ABORT RECEIVER (OTHER THAN M.IOEX) 

RX90 

TASK HAS MADE A RUN REQUEST END ACTION ROUTINE EXIT 
WHILE THE RUN REQUEST INTERRUPT WAS NOT ACTIVE 

RX91 

TASK HAS ATTEMPTED NORMAL EXIT WITH A TASK INTERRUPT 
STILL ACTIVE 

RX92 

TASK HAS ATTEMPTED NORMAL EXIT WITH MESSAGES IN ITS 
RECEIVER QUEUE 

RX93 

AN INVALID RECEIVER EXIT BLOCK (RXB) ADDRESS WAS 
ENCOUNTERED DURING MESSAGE EXIT 

RX94 

AN INVALID RECEIVER EXIT BLOCK (RXB) RETURN BUFFER 
ADDRESS WAS ENCOUNTERED DURING MESSAGE EXIT 

RX95 

TASK HAS MADE A MESSAGE EXIT WHILE THE MESSAGE 
INTERRUPT WAS NOT ACTIVE 

RX96 

AN INVALID RECEIVER EXIT BLOCK (RXB) ADDRESS WAS 
ENCOUNTERED DURING RUN RECEIVER EXIT 

RX97 

AN INVALID RECEIVER EXIT BLOCK (RXB) RETURN BUFFER 
ADDRESS WAS ENCOUNTERED DURING RUN RECEIVER EXIT 

RX98 

TASK HAS MADE A RUN RECEIVER EXIT WHILE THE RUN 
RECEIVER INTERRUPT WAS NOT ACTIVE 

RX99 

TASK HAS MADE A MESSAGE END-ACTION ROUTINE EXIT 
WHILE THE MESSAGE INTERRUPT WAS NOT ACTIVE 


C.30 SB - System Binary Output 

SB01 AN I/O ERROR HAS BEEN ENCOUNTERED ON THE DEVICE 

ASSIGNED AS THE SYSTEM BINARY (PUNCHED) OUTPUT 
DEVICE 

SB02 THE SYSTEM OUTPUT PROGRAM HAS ENCOUNTERED AN 

UNRECOVERABLE I/O ERROR IN ATTEMPTING TO READ A 
PUNCHED OUTPUT FILE FROM DISC 

SB03 DENIAL OF FILE CODE TO FILE CODE ALLOCATION FOR 

J.SOUT2 INDICATES LOSS OF SYSTEM INTEGRITY 
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SB - System Binary Output 


SB04 SYSTEM BINARY OUTPUT ABORTED BY OPERATOR 

SB05 NO TIMER ENTRY FOR SYSTEM BINARY OUTPUT (SYSTEM 

FAULT) 

SB06 FIVE ECHO CHECK ERRORS DETECTED WHILE ATTEMPTING TO 

PUNCH A SINGLE CARD 


C.31 SC - System Check Trap Processor 

SC01 SYSTEM CHECK TRAP OCCURRED AT AN ADDRESS LOCATED 

WITHIN THE OPERATING SYSTEM 

SC02 SYSTEM CHECK TRAP OCCURRED WITHIN THE CURRENT TASK'S 

SPACE 

SCO 3 SYSTEM CHECK TRAP OCCURRED AT A TIME WHEN THERE WERE 

NO TASKS CURRENTLY BEING EXECUTED (C.PRNO EQUALS 
ZERO) 

SCO 4 SYSTEM CHECK TRAP OCCURRED WITHIN ANOTHER TRAP 

(C.GINT DOES NOT EQUAL '1') 

C.32 SD- SCSI Disk 


SDOO NO ADDITIONAL SENSE INFORMATION 

SD01 NO INDEX/SECTOR SIGNAL 

SD02 NO SEEK COMPLETE 

SD03 WRITE FAULT 

SD04 DRIVE NOT READY 

SD05 DRIVE NOT SELECTED 

SD06 NO TRACK ZERO FOUND 

SD07 MULTIPLE DRIVES SELECTED 

SD08 LOGICAL UNIT COMMUNICATIONS FAILURE 

SDO 9 TRACK FOLLOWING ERROR 

SD10-SD15 Reserved 

SD16 ID CRC OR ECC ERROR 

SD17 UNRECOVERED READ ERROR OF DATA BLOCKS 


SD18 NO ADDRESS MARK FOUND IN ID FIELD 
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SD - SCSI Disk 


SD19 

SD20 

SD21 

SD22 

SD23 

SD24 

SD25 
SD26 
SD27 
SD28 
SD2 9 
SD30 
SD31 
SD32 
SD33 

SD34 

SD35 

SD36 

SD37 

SD38 

SD39 

SD40 

SD41 

SD42 

SD43-SD47 

SD48 


NO ADDRESS MARK FOUND IN DATA FIELD 

NO RECORD FOUND 

SEEK POSITIONING ERROR 

DATA SYNCHRONIZATION MARK ERROR 

RECOVERED READ DATA WITH TARGET'S READ RETRIES (NOT 
WITH ECC) 

RECOVERED READ DATA WITH TARGET'S ECC CORRECTION 
(NOT WITH RETRIES) 

DEFECT LIST ERROR 

PARAMETER OVERRUN 

SYNCHRONOUS TRANSFER ERROR 

PRIMARY DEFECT LIST NOT FOUND 

COMPARE ERROR 

RECOVERED ID WITH TARGET'S ECC CORRECTION 

Reserved 

INVALID COMMAND OPERATION CODE 

ILLEGAL LOGICAL BLOCK ADDRESS. ADDRESS GREATER THAN 
THE LBA RETURNED BY THE READ CAPACITY DATA WITH PMI 
BIT NOT SET IN CDB 

ILLEGAL FUNCTION FOR DEVICE TYPE 

Reserved 

ILLEGAL FIELD IN CDB 
INVALID LUN 

INVALID FIELD IN PARAMETER LIST 
WRITE PROTECTED 
MEDIUM CHANGE 

POWER ON OR RESET OR BUS DEVICE RESET OCCURRED 
MODE SELECT PARAMETERS CHANGED 

Reserved 

INCOMPATIBLE CARTRIDGE 
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SD - SCSI Disk 


SD49 MEDIUM FORMAT CORRUPTED 

SD50 NO DEFECT SPARE LOCATION AVAILABLE 

SD51-SD63 Reserved 
SD64 RAM FAILURE 

SD65 DATA PATH DIAGNOSTIC FAILURE 

SD66 POWER ON DIAGNOSTIC FAILURE 

SD67 MESSAGE REJECT ERROR 

SD68 INTERNAL CONTROLLER ERROR 

SD69 SELECT/RESELECT FAILED 

SD70 UNSUCCESSFUL SOFT RESET 

SD71 SCSI INTERFACE PARITY ERROR 

SD72 INITIATOR DETECTED ERROR 


SD73 INAPPROPRIATE/ ILLEGAL MESSAGE 


C.33 SG - System Generator (SYSGEN) 

SG01 INVALID LOADER FUNCTION CODE IN BINARY OBJECT MODULE 

FROM THE SYSTEM RESIDENT MODULE (OBJ) FILE 

SG02 INVALID BINARY RECORD READ FROM SYSTEM RESIDENT 

MODULE (OBJ) FILE (BYTE 0 MUST BE X'FF' OR X'DF') 

SG03 SEQUENCE ERROR IN MODULE BEING READ FROM TEMPORARY 


SG04 CHECKSUM ERROR IN MODULE BEING READ FROM TEMPORARY 

FILE 

SG05 UNABLE TO FIND CDT AND/OR UDT FOR I/O MODULE LOAD 

SG06 UNABLE TO OBTAIN ADDITIONAL MEMORY REQUIRED FOR 

RESIDENT SYSTEM IMAGE MODULE LOADING 

SG07 UNABLE TO OBTAIN MEMORY REQUIRED FOR RESIDENT SYSTEM 

IMAGE CONSTRUCTION 

SG08 NON-RELOCATABLE BYTE STRING ENCOUNTERED IN BINARY 

MODULE BEING PROCESSED FROM TEMPORARY FILE 

SG09 UNABLE TO ALLOCATE TEMPORARY FILE SPACE 

SG10 OVERRUN OF SYSGEN ADDRESS SPACE BY SYSTEM BEING 

GENERATED. PROBABLE ERRONEOUS SIZE SPECIFICATION IN 
PATCH OR POOL DIRECTIVE. 
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SG - System Generator (SYSGEN) 


SGll 

SG12 

SG13 

SG14 

SG15 

SG16 

SG17 

SG18 

SG19 

SG20 

SG21 

SG22 

SG23 

SG24 
SG25 
SG2 6 

SG27 

SG28 

MPX-32 Reference 


SEQUENCE ERROR WHILE READING OBJECT MODULE FROM FILE 
ASSIGNED TO 'OBJ' 

CHECKSUM ERROR WHILE READING OBJECT MODULE FROM FILE 
ASSIGNED TO 'OBJ' 

UNABLE TO ALLOCATE DISC SPACE FOR SYMTAB FILE. 
POSSIBLE CAUSES ARE INSUFFICIENT DISC SPACE OR 
ACCESS RIGHTS DENIAL. 

UNABLE TO ALLOCATE DISC SPACE FOR SYSTEM IMAGE FILE. 
POSSIBLE CAUSES ARE INSUFFICIENT DISC SPACE, ACCESS 
RIGHTS DENIAL, OR ATTEMPTING TO SYSGEN OVER CURRENT 
DEFAULT IMAGE. 

MAXIMUM NUMBER (240) OF SYMBOL TABLE/PATCH FILE 
ENTRIES EXCEEDED 

MISSING SYSTEM OR SYMTAB DIRECTIVE 

INVALID IPU INTERVAL TIMER PRIORITY. MUST NOT BE 
BETWEEN X' 78' AND X' 7F' . 

MAXIMUM SIZE OF 88K FOR TARGET SYSTEM HAS BEEN 
EXCEEDED 

ATTEMPT TO DEFINE INTERRUPT VECTORING ROUTINE AS 
SYSTEM REENTRANT. ONLY DEVICE HANDLERS MAY BE SYSTEM 
REENTRANT . 

UNABLE TO FIND "LINK" DEVICE IN UDT 

INSUFFICIENT ROOM IN MEMORY POOL FOR DOWNLOAD FILE 
LIST 

Reserved 

SHARE DIRECTIVE SPECIFIED WITHOUT ENOUGH SMT 
ENTRIES. ENTRIES MUST EXCEED OR BE EQUAL TO THE 
NUMBER OF PARTITIONS PLUS MEMORY DISCS. 

ATTEMPT TO DEFINE PARTITION STARTING MAPBLOCK NUMBER 
IN OPERATING SYSTEM AREA 

ATTEMPT TO DEFINE PARTITION STARTING MAPBLOCK NUMBER 
IN NON-CONFIGURED PHYSICAL MEMORY 

ATTEMPT TO USE A MODULE INCOMPATIBLE WITH THE TARGET 
MACHINE TYPE. THE OFFENDING MODULE NAME IS THE LAST 
ENTRY ON THE LISTING FOLLOWED BY THREE ASTERISKS 
(***) 


THE DEVICE SPECIFIED IN EITHER THE SWAPDEV, SID, LOD 
OR POD DIRECTIVE IS NOT INCLUDED IN THE 
CONFIGURATION BEING BUILT 

THE NULL DEVICE SPECIFICATION WHICH IS REQUIRED TO 
BE INCLUDED IN EVERY CONFIGURATION IS MISSING 
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SG - System Generator (SYSGEN) 


SG29 SYSINIT OBJECT MODULE MISSING ON SYSGEN OBJECT INPUT 

FILE (OBJ) . IT MUST BE THE LAST MODULE. 

SG30 THE FILE ASSIGNED TO FILE CODE OBJ DOES NOT CONTAIN 

VALID OBJECT CODE 

SG31 THE GENERATED IMAGE CONTAINS UNSATISFIED EXTERNAL 

REFERENCES. SEE THE SLO OUTPUT FOR MORE DETAILS. 
THIS IS NOT A FATAL ABORT AND THE SYSTEM IMAGE IS 
PRODUCED . 

SG32 ONE OR MORE REQUESTED OBJECT MODULES COULD NOT BE 

LOCATED ON THE INPUT OBJECT FILE. SEE THE SLO 
OUTPUT FOR MORE DETAILS. THIS IS NOT A FATAL ABORT 
AND THE SYSTEM IMAGE IS PRODUCED. 

SG33 EVENT TRACE HAS BEEN ENABLED WITH NO MEMORY 

PARTITION RESERVED FROM X' 78000' TO X' 80000' 

SG34 Reserved 

SG35 INSUFFICIENT MEMORY POOL FOR STATIC PARTITION 

SG36 UNMAPPED DEBUG MODULE (H.DBUG2) IS MISSING ON SYSGEN 

OBJECT INPUT FILE. IT MUST BE THE LAST MODULE IF THE 
SYSTEM DEBUGGER IS TO BE CONFIGURED. 

SG37 COMMUNICATION REGION + DSECT + ADAPTIVE REGION 

EXCEEDS 16KW 

SG38 MPX EXTENDED CODE AREA EXTENDS PAST LOGICAL LIMIT 

SG39 INVALID MPX EXTENDED CODE AREA LOGICAL MAP START 

SG40 DIRECTIVE ERRORS ENCOUNTERED. IMAGE PRODUCED. 

SG41 H.IPPF COULD NOT BE LOCATED ON THE INPUT OBJECT 

FILE. MODULE IS NECESSARY FOR DEMAND PAGE. 

SG42-SG97 Reserved 

SG98 ERROR ENCOUNTERED DURING OBJECT PROCESSING PRECEDED 

BY MESSAGE DESCRIBING THE ERROR CONDITION 

SG99 DIRECTIVE ERRORS ENCOUNTERED 


C.34 SH - Shadow Memory (J.SHAD) 

SH01 J.SHAD ABORTED. SEE OUTPUT (UT IF INTERACTIVE OR SLO 

IF BATCH), FOR ACTUAL ERROR DESCRIPTION ( S ) . 


C.35 SN - System Input Task (J.SSIN) 


SN00 INVALID RUN REQUEST PARAMETERS 
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SS - Sort/Merge (FSORT2) 


C.36 SS - Sort/Merge (FSORT2) 


5501 

5502 

5503 

5504 

SS05-SS06 

5507 

5508 

5509 

5510 

5511 

5512 

5513 

5514 

5515 

5516 

5517 

5518 

5519 

5520 

5521 

5522 

SS23-SS27 

5528 

5529 


CTL NOT ALLOCATED 
HEADER DIRECTIVE MISSING 
CONTROL FILE EMPTY 
DIRECTIVE CODE NOT VALID 

Reserved 

OUTPUT FILE CODE (OUT) NOT ALLOCATED 

RECORD LENGTH NOT DIVISIBLE INTO INPUT PHYSICAL 
RECORD LENGTH 

RECORD LENGTH EXCEEDS INPUT PHYSICAL RECORD LENGTH 

INPUT RECORD LENGTH EXCEEDS MAXIMUM ALLOWED (4095) 

RECORD LENGTH NOT DIVISIBLE INTO OUTPUT PHYSICAL 
RECORD LENGTH 

RECORD LENGTH EXCEEDS OUTPUT BLOCK LENGTH 

OUTPUT PHYSICAL RECORD LENGTH EXCEEDS MAXIMUM 
ALLOWED (4095) 

..1 PRESENT BUT NOT A DISC FILE 
..2 PRESENT BUT NOT A DISC FILE 
COMPARISON INDICATOR NOT VALID 

Reserved 

WKl HAS BEEN ALLOCATED BY THE USER 
WK2 HAS BEEN ALLOCATED BY THE USER 

FIELD DIRECTIVE ERROR: STARTING POSITION IS GREATER 
THAN FIELD ENDING POSITION 

FIELD DIRECTIVE ERROR: STARTING POSITION EXCEEDS 
RECORD LENGTH 

FIELD DIRECTIVE ERROR: ENDING POSITION EXCEEDS 
LOGICAL RECORD LENGTH 

Reserved 

INAPPROPRIATE COMBINATION OF TOURNAMENT PARAMETERS 
EXCEEDS MEMORY POOL LIMITS 

DISC SPACE CANNOT BE ALLOCATED FOR WORK FILE 1 
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SS - Sort/Merge (FSORT2) 


5530 

5531 

5532 

SS33-SS39 

5540 

5541 

5542 

SS43-SS47 

SS48 

SS49-SS57 

5558 

5559 

SS60-SS68 

SS69 

SS70-SS97 

5598 

5599 


DISC SPACE CANNOT BE ALLOCATED FOR WORK FILE 2 
FILE TO FILE ALLOCATION FOR WORKFILE HAS FAILED 
SORT BUFFER TOO SMALL 

Reserved 

INPUT FILES ARE EMPTY: NO RECORD INPUT OR SORTED 
WK1 OR WK2 FILES TOO SMALL 

MERGE ONLY SELECTED BUT NO MERGE FILES (MG1-MG8) ARE 
ASSIGNED 

Reserved 

SORT ATTEMPTED WITHOUT GOOD CALL TO SORT : HDR 

Reserved 

INAPPROPRIATE COMBINATION OF BUFFER PARAMETERS 
DETECTED DURING OUTPUT PHASE 

END OF MEDIUM DETECTED ON THE OUT FILE 

Reserved 

COMPARE TABLE TYPE DESTROYED: SORT PROBLEM 

Reserved 

ERROR OPENING FILE LO 
ERROR OPENING FILE OUT 


C.37 ST - System Output Task (J.SOUT) 


ST01 UNRECOVERABLE WRITE ERROR TO DESTINATION DEVICE 

ST02 UNABLE TO PERFORM ALLOCATION OF SEPARATOR FILE CODE 

ST03 UNABLE TO ISSUE MAGNETIC TAPE MOUNT MESSAGE VIA 

ALLOCATION SERVICE 

Whenever a system output task aborts, the task may be restarted with the OPCOM 
REPRINT or REPUNCH commands. 


C.38 S V - SVC Trap Processor (H.IP06) 

SV01 UNPRIVILEGED TASK ATTEMPTING TO USE M.CALL 

SV02 INVALID SVC NUMBER 
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SV - SVC Trap Processor (H.IP06) 


SV03 UNPRIVILEGED TASK ATTEMPTING TO USE A 'PRIVILEGED- 

ONLY' SERVICE 

SV04 INVALID SVC TYPE 

SV05 UNPRIVILEGED TASK ATTEMPTING TO USE M.RTRN 

SV06 INVALID MODULE NUMBER OR ENTRY POINT 

SV07 ATTEMPTING TO USE A SVC WHICH IS INVALID FOR BASE 

REGISTER OPERATIONS 

SV08 SVC 0, 1 OR 2 ATTEMPTED THAT WOULD RESULT IN A TSA 

STACK OVERFLOW (I.E. T.REGP GREATER THAN T.LASTP) 

SV09 ATTEMPT TO USE A COMPATIBLE MODE SERVICE WITH NOCMS 

SPECIFIED IN SYSGEN 

C.39 SW - Swap Scheduler Task (J.SWAPR) 

SW01 I/O ERROR ON INSWAP OR OUTSWAP 

SW02 EOM DETECTED ON SWAP FILE 

SW03 CAN NOT CREATE SWAP FILE SPACE DIRECTORY IN MEMORY 

POOL 

SW04 SWAP FILE SPACE DIRECTORY IS FULL 

SW05 TASK HAS REQUESTED INSWAP BUT WAS NEVER OUTSWAPPED 

C.40 SX - System Output Executive (J.SOEX) 

SX01 INVALID RUN REQUEST HEADCELL COUNT 

SX02 LOAD MODULE J.SOUT DOES NOT EXIST 

C.41 SY - System Initialization (SYSINIT) 

SY01 SYSTEM HALT OCCURRED DURING SYSINIT PHASE ONE 

PROCESSING 

SY02 SYSTEM HALT DUE TO MEMORY PARITY ERROR BEING 

DETECTED IN THE OPERATING SYSTEM 
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TD - Terminal Type Set/Reset Utility (J.TSET) 


C.42 TD - Terminai Type Set/Reset Utility (J.TSET) 

TDOl ATTEMPTED TO RUN J.TSET IN BATCH MODE 

TD02 J.TSET WAS UNABLE TO OPEN UT FOR PROCESSING 

C.43 TS - Terminal Support 

TSOI USER REQUESTED REMOVAL FROM A BREAK REQUEST 

TS02 USER REQUESTED REMOVAL FROM A RESOURCE WAIT STATE 

QUEUE 

TS03 TASK RUNNING FROM SPECIFIED TERMINAL WAS ABORTED 

WHEN THE TERMINAL DISCONNECTED 

TS04 REMOVAL OF a JOB WAS REQUESTED 

C.44 Ul - Undefined Instruction Trap 

UI01 UNDEFINED INSTRUCTION TRAP 

UI02 UNEXPECTED DEBUGX32 BREAKPOINT FOUND AND DEBUGX32 

NOT ATTACHED 

C.45 VF - Volume Formatter (J.VFMT) 

VF01 ERROR HAS OCCURRED. SEE SLO FILE FOR EXPLANATION. 

VF02 OPEN FAILURE ON AUDIT TRAIL DEVICE/FILE 

VF03 EOF/EOM ON AUDIT TRAIL DEVICE/FILE 

VF04 I/O ERROR ON AUDIT TRAIL DEVICE/FILE 

C.46 VM - Volume Management Module (H.VOMM) 

In some cases, H.VOMM displays H.REMM abort conditions. If a user calls an 
H.VOMM service which in turn calls an H.REMM service for processing and an abort 
condition occurs within the H.REMM processing, the abort condition is returned to 
H.VOMM which displays it to the user in the format 1 Oxx where xx is the specific 
H.REMM abort condition. For example, abort condition 1026 indicates H.REMM 
error 26 has occurred. The TSM $ERR command can be used to determine the reason 
for the error, i.e., $err RM26. 

VM01 INVALID PATHNAME 

VM02 PATHNAME CONSISTS OF VOLUME ONLY 
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VM - Volume Management Module (H.VOMM) 


VM03 

VM04 

VM05 

VM06 

VM07 

VM08 

VM09 

VM10 

VM11 

VM12 

VM13 

VM14 

VM15 

VM16 

VM17 

VM18 

VM19 

VM20 

VM21 

VM22 

VM23 

VM24 

VM25 

VM26 

VM27 

VM28 

VM29 

VM30 


VOLUME NOT MOUNTED 
DIRECTORY DOES NOT EXIST 
DIRECTORY NAME IN USE 

DIRECTORY CREATION NOT ALLOWED AT SPECIFIED LEVEL 

RESOURCE DOES NOT EXIST 

RESOURCE ALREADY EXISTS 

RESOURCE DESCRIPTOR UNAVAILABLE 

DIRECTORY ENTRY UNAVAILABLE 

REQUIRED FILE SPACE UNAVAILABLE 


UNRECOVERABLE 

I/O 

ERROR 

READING 

DMAP 

UNRECOVERABLE 

I/O 

ERROR 

WRITING 

DMAP 

UNRECOVERABLE 

I/O 

ERROR 

READING 

RESOURCE DESCRIPTOR 

UNRECOVERABLE 

I/O 

ERROR 

WRITING 

RESOURCE DESCRIPTOR 

UNRECOVERABLE 

I/O 

ERROR 

READING 

SMAP 

UNRECOVERABLE 

I/O 

ERROR 

WRITING 

SMAP 

UNRECOVERABLE 

I/O 

ERROR 

READING 

DIRECTORY 

UNRECOVERABLE 

I/O 

ERROR 

WRITING 

DIRECTORY 

PROJECTGROUP NAME 

OR KEY INVALID 


Reserved 

INVALID FILE CONTROL BLOCK (FCB) OR LFC 
PARAMETER ADDRESS SPECIFICATION ERROR 
RESOURCE DESCRIPTOR NOT CURRENTLY ALLOCATED 
PATHNAME BLOCK OVERFLOW 
FILE SPACE NOT CURRENTLY ALLOCATED 
'CHANGE DEFAULTS' NOT ALLOWED 

RESOURCE CANNOT BE ACCESSED IN REQUESTED MODE OR 
DEFAULT SYSTEM IMAGE FILE CANNOT BE DELETED 

OPERATION NOT ALLOWED ON THIS RESOURCE TYPE 
(RESOURCE IS NOT CORRECT TYPE) 

REQUIRED PARAMETER WAS NOT SPECIFIED 
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VM - Volume Management Module (H.VOMM) 


VM31 

VM32 

VM33 

VM34 

VM35 

VM36 

VM37 

VM38 

VM39 
VM4 0 

VM4 1 
VM42 

VM43 

VM44 

VM4 5 

VM4 6 

VM4 7 

VM4 8 
VM4 9 

VM50 

VM51 


FILE EXTENSION DENIED. SEGMENT DEFINITION AREA FULL. 

FILE EXTENSION DENIED. FILE WOULD EXCEED MAXIMUM 
SIZE ALLOWED. 

I/O ERROR OCCURRED WHEN RESOURCE WAS ZEROED 
REPLACEMENT FILE CANNOT BE ALLOCATED 
INVALID DIRECTORY ENTRY 

DIRECTORY AND FILE ARE NOT ON THE SAME VOLUME 

AN UNIMPLEMENTED ENTRY POINT HAS BEEN CALLED 

REPLACEMENT FILE IS ALLOCATED BY ANOTHER TASK AND 
BIT 0 IN THE CNP OPTION FIELD IS NOT SET, OR FILE IS 
ALLOCATED BY OTHER CPU IN MULTI-PORT ENVIRONMENT 

OUT OF SYSTEM SPACE 

CANNOT ALLOCATE FAT/FPT WHEN CREATING A TEMPORARY 
FILE 

DEALLOCATE ERROR IN ZEROING FILE 

RESOURCE DESCRIPTOR DESTROYED OR THE RESOURCE 
DESCRIPTOR AND THE DIRECTORY ENTRY LINKAGE HAS BEEN 
DESTROYED 

INVALID RESOURCE SPECIFICATION 

INTERNAL LOGIC ERROR FROM RESOURCE MANAGEMENT MODULE 
(H.REMM) . ABORT TASK, TRY A DIFFERENT TASK AND IF IT 
FAILS, REBOOT SYSTEM. 

ATTEMPTED TO MODIFY MORE THAN ONE RESOURCE 
DESCRIPTOR AT THE SAME TIME OR ATTEMPTED TO REWRITE 
A RESOURCE DESCRIPTOR PRIOR TO MODIFYING IT 

RESOURCE DESCRIPTOR IS LOCKED BY ANOTHER CPU 
(MULTI-PORT ONLY) 

DIRECTORY CONTAINS ACTIVE ENTRIES AND CANNOT BE 
DELETED 

A RESOURCE DESCRIPTOR'S LINK COUNT IS ZERO 

ATTEMPTING TO DELETE A PERMANENT RESOURCE WITHOUT 
SPECIFYING A PATHNAME OR PATHNAME BLOCK VECTOR 

RESOURCE DESCRIPTOR CONTAINS UNEXPECTED RESOURCE 
DESCRIPTOR TYPE 

DIRECTORY ENTRY DELETED BUT FAILED TO RELEASE FILE 
SPACE 



V.../ 
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VM - Volume Management Module (H.VOMM) 


VM52 AN ATTEMPT WAS MADE TO DEALLOCATE FREE SPACE OR TO 

ALLOCATE SPACE THAT IS CURRENTLY ALLOCATED ON A 
VOLUME OTHER THAN SYSTEM DISC 

VM53 THE FILE SPACE CREATED IS LESS THAN THE SPACE 

REQUESTED 

VM5 4 VM 9 8 Reserved 

VM99 AN ATTEMPT WAS MADE TO DEALLOCATE FREE SPACE OR TO 

ALLOCATE SPACE THAT IS CURRENTLY ALLOCATED ON THE 
SYSTEM VOLUME 


C.47 VO - Volume Manager (VOLMGR) 

VOOl ERROR HAS OCCURRED. SEE SLO FILE FOR EXPLANATION. 

V002 OPEN FAILURE ON AUDIT TRAIL DEVICE/FILE 

VO03 EOF/EOM ON AUDIT TRAIL DEVICE/FILE 

VO04 I/O ERROR ON AUDIT TRAIL DEVICE/FILE 

VO 05 Reserved 

VO06 I/O ERROR ON THE TAPE DURING SAVE OPERATION. TAPE 

HAS BEEN BACKSPACED TO THE END OF THE LAST SAVED 
FILE. ALL FILES ON THE IMAGE PRIOR TO THE TAPE I/O 
ERROR ARE SAVED ON THE TAPE. 
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Crash Codes 


C.48 Crash Codes 

When system crash occurs as a result of a trap handler entry, the CPU halts with the 
registers containing the following information: 


Register 

0 

1 

2 

3 

4 

5 


6 

7 


Contents 


PSD Word 0 (when trap generated) 
PSD Word 1 (when trap generated) 
Real address of instruction causing trap 
Instruction causing trap 
CPU status word (from trap handler) 
Crash code: 


MP01=X’4D503031’ 
NMO 1 =X ’4E4D303 1 ’ 
UI01=X’55493031’ 
PV01=X’50563031’ 
MC01=X’4D433031 ’ 
SC01=X’53433031’ 
MF01=X’4D463031’ 
CP01=X ’43503031’ 
SW01=X’53573031’ 


(See H.IP02 Codes) 

(Nonpresent Memory - H.IP03) 

(Undefined Instruction - H.IP04) 

(Privilege Violation - H.IP05) 

(Machine Check - H.IP07) 

(System Check - H.DP08) 

(Map Fault - H.IP09) 

(Cache Parity Error - H.IP10) 32/67, 32/87 and 32/97 
(See SWAPR codes) 


Real address of register save block 
C’TRAP’=X’54524150’ 


For further description, see Volume I, Chapter 2. 
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D Numerical Information 


2 n 

n 

2 -n 

1 

0 

1.0 

2 

1 

0.5 

4 

2 

0.25 

8 

3 

0.125 

16 

4 

0.062 5 

32 

5 

0.031 25 

64 

6 

0.015 625 

128 

7 

0.007 812 5 

256 

8 

0.003 906 25 

512 

9 

0.001 953 125 

1 024 

10 

0.000 976 562 5 

2 048 

11 

0.000 488 281 25 

4 096 

12 

0.000 244 140 625 

8 192 

13 

0.000 122 070 312 5 

16 384 

14 

0.000 061 03515625 

32 768 

15 

0.000 030 517 578125 

65 536 

16 

0.000 015 258 789 062 5 

131 072 

17 

0.000 007 629 394 531 25 

262 144 

18 

0.000 003 814 697 265 625 

524 288 

19 

0.000 001 907 348 632 812 5 

1 048 576 

20 

0.000 000 953 674 31 6 406 25 

2 097 152 

21 

0.000 000 476 837 1 58 203 1 25 

4194 304 

22 

0.000 000 238 418 579 101 562 5 

8 388 608 

23 

0.000 000 1 1 9 209 289 550 781 25 

16 777 216 

24 

0.000 000 059 604 644 775 390 625 

33 554 432 

25 

0.000 000 029 802 322 387 695 312 5 

67 108 864 

26 

0.000 000 014 901 161 193 847 656 25 

134 217 728 

27 

0.000 000 007 450 580 596 923 828 125 

268 435 456 

28 

0.000 000 003 725 290 298 461 914 062 5 

536 870 912 

29 

0.000 000 001 862 645 149 230 957 031 25 

1 073 741 824 

30 

0.000 000 000 931 322 574 615 478 515 625 

2 147 483 648 

31 

0.000 000 000 465 661 287 307 739 257 812 5 
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Numerical Information 


2 n n 2 " n 


4 294 967 296 

32 

8 589 934 592 

33 

17179 869 184 

34 

34 359 738 368 

35 


0.000 000 000 232 830 643 653 869 628 906 25 
0.000 000 000 116 415 321 826 934 814 453 1 25 
0.000 000 000 058 207 660 913 467 407 226 562 5 
0.000 000 000 029 103 830 456 733 703 613 281 25 


68 719 476 736 36 

137 438 953 472 37 

274 877 906 944 38 

549 755 813 888 39 


0.000 000 000 014 551 915 228 366 851 806 640 625 
0.000 000 000 007 275 957 614 183 425 903 320 312 5 
0.000 000 000 003 637 978 807 091 712 951 660 156 25 
0.000 000 000 001 818 989 403 545 856 475 830 078 125 


1 099 511 627 776 40 

2199 023 255 552 41 

4 398 046 511 104 42 

8 796 093 022 208 43 


0.000 000 000 000 909 494 701 772 928 237 915 039 062 5 
0.000 000 000 000 454 747 350 886 464 1 18 957 519 531 25 
0.000 000 000 000 227 373 675 443 232 059 478 759 765 625 
0.000 000 000 000 1 1 3 686 837 721 61 6 029 739 379 882 81 2 5 


17 592 186 044 416 44 

35 184 372 088 832 45 

70 368 744 177 664 46 

140 737 488 355 328 47 


0.000 000 000 000 056 843 418 860 808 014 869 689 941 406 25 
0.000 000 000 000 028 421 709 430 404 007 434 844 970 703 125 
0.000 000 000 000 014 210 854 715 202 003 717 422 485 351 562 5 
0.000 000 000 000 007 105 427 357 601 001 858 71 1 242 675 781 25 


281 474 976 710 656 48 

562 949 953 421 312 49 

1 125 899 906 842 624 50 

2 251 799 813 685 248 51 


0.000 000 000 000 003 552 713 678 800 500 929 355 621 337 890 625 
0.000 000 000 000 001 776 356 839 400 250 464 677 81 0 668 945 31 2 5 
0.000 000 000 000 000 888 178 419 700 125 232 338 905 334 472 656 25 
0.000 000 000 000 000 444 089 209 850 062 616 169 452 667 236 328 125 


4 503 599 627 370 496 52 

9 007199 254 740 992 53 

18 014 398 509 481 984 54 

36 028 797 01 8 963 968 55 


0.000 000 000 000 000 222 044 604 925 031 308 084 726 333 618 164 062 5 
0.000 000 000 000 000 111 022 302 462 515 654 042 363 166 809 082 031 25 
0.000 000 000 000 000 055 511 151 231 257 827 021 181 583 404 541 015625 
0.000 000 000 000 000 027 755 575 615 628 913 510 590 791 702 270 507 812 5 


72 057 594 037 927 936 56 

144 115 188 075 855 872 57 

288 230 376151 711 744 58 

576 460 752 303 423 488 59 


0.000 000 000 000 000 013 877 787 807 814 456 755 295 395 851 135 253 906 25 
0.000 000 000 000 000 006 938 893 903 907 228 377 647 697 925 567 626 953 125 
0.000 000 000 000 000 003 469 446 951 953 614 188 823 848 962 783 813 476 562 5 
0.000 000 000 000 000 001 734 723 475 976 807 094 41 1 924 481 391 906 738 281 25 


1 1 52 921 504 606 846 976 60 

2 305 843 009 213 693 952 61 

4 61 1 686 018 427 387 904 62 

9 223 372 036 854 775 808 63 


0.000 000 000 000 000 000 867 361 737 988 403 547 205 962 240 695 953 369 140 625 
0.000 000 000 000 000 000 433 680 868 994 201 773 602 981 120 347 976 684 570 312 5 
0.000 000 000 000 000 000 216 840 434 497 100 886 801 490 560 173 988 342 285 156 25 
0.000 000 000 000 000 000 108 420 217 248 550 443 400 745 380 086 994 171 142 578 125 


87D13D01 


D-2 


Numerical Information 



Powers of Integers 


E.1 Powers of Sixteen in Decimal 

16" 

i 

16 
256 
4 096 

65 536 

1 048 576 

16 777 216 

268 435 456 

4 294 967 296 

68 719 476 736 

1 099 511 627 776 

17 592 186 044 416 

281 474 976 710 656 

4 503 599 627 370 496 

72 057 594 037 927 936 

1 152 921 504 606 846 976 

( 


c 
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16' n 


0 

0.10000 

00000 

00000 

00000 

X 

10 

1 

0.62500 

00000 

00000 

00000 

X 

10' 1 

2 

0.39062 

50000 

00000 

00000 

X 

10' 2 

3 

0.24414 

06250 

00000 

00000 

X 

10' 3 

4 

0.15258 

78906 

25000 

00000 

X 

10' 4 

5 

0.95367 

43164 

06250 

00000 

X 

10' 6 

6 

0.59604 

64477 

53906 

25000 

X 

10' 7 

7 

0.37252 

90298 

46191 

40625 

X 

10' 8 

8 

0.23283 

06436 

53869 

62891 

X 

10' 9 

9 

0.14551 

91522 

83668 

51807 

X 

10' 10 

10 

0.90949 

47017 

72928 

23792 

X 

10' 11 

11 

0.56843 

41886 

08080 

14870 

X 

10' 13 

12 

0.35527 

13678 

80050 

09294 

X 

10' 14 

13 

0.22204 

46049 

25031 

30808 

X 

10' 15 

14 

0.13877 

78780 

78144 

56755 

X 

10' 16 

15 

0.86736 

17379 

88403 

54721 

X 

10~ 18 





Powers of Ten in Hexadecimal 


E.2 Powers of Ten in Hexadecimal 


10 " 

1 

A 

64 

3E8 

2710 




1 

86A0 



F 

4240 



98 

9680 



5F5 

E100 



3B9A 

CA00 


2 

540B 

E400 


17 

4876 

E800 


E8 

D4A5 

1000 


918 

4E72 

A000 


5AF3 

107A 

4000 

3 

8D7E 

A4C6 

8000 

23 

86F2 

6FC1 

0000 

163 

4578 

5D8A 

0000 

DFO 

B6B3 

A764 

0000 

8AC7 

2304 

89E8 

0000 


n 


0 

1.0000 

0000 

1 

0.1999 

9999 

2 

0.28F5 

C28F 

3 

0.4189 

374B 

4 

0.68DB 

8BAC 

5 

0.A7C5 

AC47 

6 

0.10C6 

F7A0 

7 

0.1AD7 

F29A 

8 

0.2 AF3 

1DC4 

9 

0.44B8 

2FA0 

10 

0.6DF3 

7F67 

11 

0.AFEB 

FFOB 

12 

0.1197 

9981 

13 

0.1C25 

C268 

14 

0.2D09 

370D 

15 

0.480E 

BE7B 

16 

0.734A 

CA5F 

17 

0.B877 

AA3 

18 

0.1272 

5DD1 

19 

0.1D83 

C94F 


10 " 


0000 

9999 

5C28 

0000 

999A 

F5C3 

X 

16 1 

C6A7 

EF9E 

X 

16' 2 

7 IOC 

B296 

X 

16’ 3 

1B47 

8423 

X 

16’ 4 

B5ED 

8D37 

X 

16” 4 

BCAF 

4858 

X 

16 5 

6118 

73BF 

X 

16~ 6 

9B5A 

52CC 

X 

16 7 

5EF6 

EADF 

X 

16' 8 

CB24 

AAFF 

X 

16 9 

2DEA 

1119 

X 

16’ 9 

4976 

81C2 

X 

16 10 

4257 

3604 

X 

16 11 

9D58 

566D 

X 

16' 12 

6226 

FOAE 

X 

16 13 

36A4 

B449 

X 

16 14 

D243 

ABA1 

X 

16 14 

B6D2 

AC35 

X 

16’ 15 
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F ASCII Interchange Code Set 


Row 

Col 

0 

1 

2 

3 

4 

5 

6 

7 

1 Bit Positions 









4 


0- 

— 0 

0 

0 

0 

0 

0 

0 

0 


5 

1 — 

— *0 

0 

0 

0 

1 

1 

1 

1 


I 6 

2 — 

0 

0 

1 

1 

0 

0 

1 

1 


If 

3 

0 

1 

0 

1 

0 

1 

0 

1 

0 

III 

000 

0 

NUL 

DLE 

SP 

0 

@ 

P 

1 

P 




12-0-9-8-1 

12-11-9-8-1 

No Punch 

0 

8-4 

11-7 

8-1 

12-11-7 

! 0001 

1 

SOH 

DC1 

! 

1 

A 

Q 

a 

q 




12-9-1 

11-9-1 

12-8-7 

1 

12-1 

11-8 

12-0-1 

1 2-1 1 -8 

I 0010 

2 

STX 

DC2 

- 

2 

B 

R 

b 

r 




12-9-2 

11-9-2 

8-7 

2 

12-2 

11-9 

12-0-2 

12-11-9 

I 0011 

3 

ETX 

DC3 

# 

3 

C 

S 

c 

s 




12-9-3 

11-9-3 

8-3 

3 

12-3 

0-2 

12-0-3 

11-0-2 

0100 

4 

EOT 

DC4 

$ 

4 

D 

T 

d 

t 




9-7 

9-8-4 

11-8-3 

4 

12-4 

0-3 

12-0-4 

11-0-3 

0101 

5 

ENQ 

NAK 

% 

5 

E 

U 

6 

u 




0-9-8-5 

9-8-5 

0-8-4 

5 

12-5 

0-4 

12-0-5 

11-0-4 

0110 

6 

ACK 

SYN 

& 

6 

F 

V 

f 

V 




0-9-8-6 

9-2 

12 

6 

12-6 

0-5 

12-0-6 

11-0-5 

0111 

7 

BEL 

ETB 

i 

7 

G 

W 

g 

w 




0-9-8-7 

0-9-6 

8-5 

7 

12-7 

0-6 

12-0-7 

11-0-6 

1000 

8 

BS 

CAN 

{ 

8 

H 

X 

h 

X 




11-9-6 

11-9-8 

12-8-5 

8 

12-8 

0-7 

12-0-8 

11-0-7 

1001 

9 

KT 

EM 

) 

9 

1 

Y 

i 

y 




12-9-5 

11-9-8-1 

11-8-5 

9 

12-9 

0-8 

12-0-9 

11-0-8 

1010 

A 

LF 

SUB 

* 


J 

Z 

j 

z 




0-9-5 

9-8-7 

11-8-4 

8-2 

11-1 

0-9 

12-11-1 

11-0-9 

1011 

B 

VT 

ESC 

+ 


K 

[ 

k 

{ 




1 2-9-8-3 

0-9-7 

1 2-8-6 

1 1-8-6 

11-2 

12-8-2 

1 2-1 1 -2 

12-0 

1100 

C 

FF 

FS 


< 

L 

\ 

1 

1 

1 




1 2-9-8-4 

1 1 -9-8-4 

0-8-3 

12-8-4 

11-3 

0-8-2 

12-11-3 

12-11 

1101 

D 

CR 

GS 

_ 

= 

M 

] 

m 

} 




12-9-8-5 

11-9-8-5 

11 

8-6 

11-4 

11-8-5 

1 2-1 1 -4 

11-0 

1110 

E 

SO 

RS 


> 

N 

A 

n 

.V 




1 2-9-8-6 

11-9-8-6 

1 2-8-3 

0-8-6 

11-5 

11-8-7 

12-11-5 

11-0-1 

1111 

F 

SI 

US 

/ 

? 

O 


0 

DEL 

_ 



1 2-9-8-7 

11-9-8-7 

0-1 

0-8-7 

11-6 

0-8-5 

1 2-1 1 -6 

12-9-7 
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ASCII Interchange Code Set 


Some positions in the ASCII code chart may have different graphic representation on various devices as: 


ASCII IBM 029 

! I 

[ * 

] ! 

A > 


Control Characters: 



NUL - 

Null 

DC3 - 

Device Control 3 

SOH - 

Start of Heading (CC) 

DC4 - 

Device Control 4 (stop) 

STX - 

Start of Text (CC) 

NAK - 

Negative Acknowledge (CC) 

ETX - 

End of Text (CC) 

SYN - 

Synchronous Idle (CC) 

EOT - 

End of Transmission (CC) 

ETB - 

End of Transmission Block (CC) 

ENQ - 

Enquiry (CC) 

CAN - 

Cancel 

ACK - 

Acknowledge (CC) 

EM - 

End of Medium 

BEL - 

Bell (audible or attention signal) 

SS 

Start of Special Sequence 

BS - 

Backspace (FE) 

ESC - 

Escape 

H r - 

Horizontal Tabulation (punch card skip) (FE) 

FS 

File Separator (IS) 

LF 

Line Feed (FE) 

GS 

Group Separator (IS) 

VT - 

Vertical Tabulation (FE) 

RS - 

Record Separator (IS) 

FF 

Form Feed (FE) 

US 

Unit Separator (IS) 

CR - 

Carriage Return (FE) 

DEL - 

Delete 

SO - 

Shift Out 

SP - 

Space (normally nonprinting) 

SI 

Shift In 

(CC) - 

Communication Control 

DLE - 

Data Link Escape (CC) 

(FE) - 

Format Effector 

DC1 - 

Device Control 1 

(IS) - 

Information Separator 

DC2 - 

Device Control 2 
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G IOP/MFP Panel Mode Commands 


AS 

AS=xt;axux 

BAS 

BASn=xxxxuxt 

CLE 

CKMD-xxxxxxxxxxxx 

=xxxxxxxxxxxx 


cs 


CS=xxxxxxxx 


EA 

EXEC 

GPR 

GPRn=xcxmxc 

HALT 

IPL 

IPL=xrxr 

IS 


IS=xmxcu 


MA=xdxo: 

<ret> 

MAV=xxxax 

<ret> 


MD=xxxxxxxx 

=xxxxxxxx 

<ret> 

MSGE 

OVR 


Clear address stop 

Set address stop at address xxxxxxxx 

Read base registers 

Write base register n (0-7) with xxxxxxxx 
Clear memory 

Load CRAM with xxxxxxxxxxxx 

Load CRAM with data and increment address 

Read control switches 

Set control switches to xxxxxxxx 

Read effective address 

Execute CRAM 

Read general purpose registers 

Write general purpose register n (0-7) with xxxxxxxx 

Halt 

IPL from default address 

IPL from channel/subaddress xxxx 

Clear instruction stop 

Set instruction stop at address xxxxxxxx 

Read physical memory address location xxxxxx 
Increment and read memory address 

Read virtual memory address location xxxxxx 
Increment and read memory address 

Write memory data xxxxxxxx into last location addressed 
Increment and write memory data xxxxxxxx 
Increment and write previous data 

Message between primary and secondary panels (IOP only) 

Toggle clock override 
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IOP/MFP Panel Mode Commands 


PC-XXXXXX 

Load program counter with address xxxxxx 

PRIP 

Set primary panel (master; IOP only) 

PSD 

Read program status doubleword (1 and 2) 

PSD=xmxcxx 

Write program status word (2) with xxxxxxxx 

PSW 

Read program status word (1) 

PSW=xxxxaxr 

Write program status word (1) with xxxxxxxx 

RS 

Clear read operand stop 

RS=xxxxxxxx 

Set read operand stop at address xxxxxxxx 

RST 

Reset 

RUN 

Run 

SECP 

Set secondary panel (master and slave; IOP only) 

STEP 

Instruction step 

<ret> 

Continuation of instruction step 

WS 

Clear write operand stop 

WS=xxxxxxxx 

Set write operand stop at address xxxxxxxx 

@@c 

Enter console mode 

@@P 

Enter panel mode 

(LF) 

Repeat command 

Notes: 



1. Press the return key (<ret>) after each command. 

2. LOCK ON and LOCK OFF are not supported by the CRT panel. 

Console Mode 

To change from panel mode to console mode, enter @@C<ret>. 

Upon receipt of the <ret> following the @@C command, the firmware moves the 
cursor on the CRT to the extreme left margin of the next line. 

To return to the panel mode, enter @@P<ret>. When the panel mode is selected, // is 
the prompt. 
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H Standard Date and Time Formats 


H.1 Description 

With the advent of the new MPX-32 file system, proper maintenance of the system 
date and time becomes more important than ever before as all file system resources 
will be time stamped to aid in management. It is vital the date and time be kept in a 
manner that is at once useful in this application and also convenient to convert into 
other formats that the user might require. 

System date and time are kept in standard binary format. This format consists of two 
words: the first word contains the date and the second word contains the time. The 
date is maintained as the number of days since January 1, 1960 and the time is 
maintained as the binary count of system time units since midnight, adjusted to 100 
microsecond granularity. 

For the convenience of the user, monitor service calls are provided to convert the date 
and time between any of three standard formats. These are: 

1. Binary Format (described above) 

2. Byte Binary Format 

3. ASCII Format (sometimes referred to as quad ASCII format) 

Byte binary format time consists of two words: the first word contains date 
information and the second word contains time information. In byte binary format, the 
date is kept as four distinct values instead of one. Byte 0 of the date word is the 
binary century, byte 1 is the binary year in that century, byte 2 is the binary month 
and byte 3 the binary day of the month. Time is kept in a similar manner with byte 0 
being the hour, byte 1 the minute, byte 2 the second, and byte 3 the number of clock 
ticks. 

ASCII format consists of four words of information. The first two words contain the 
ASCII century, year, month, and day in successive halfwords. The second two words 
contain the hour, minutes, seconds, and clock ticks in a similar fashion. In ASCII 
format, use of a 120-hertz clock can cause truncation of the clock tick fields, allowing 
for only two ASCII digits. 
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Date/Time Standard Formats 


H.2 Date/Time Standard Formats 

Binary 


Date 


Time 


Days since 1/1/60 


Clock ticks since midnight 


Word 1 


Word 2 


Byte Binary 


Date Time 


Bin 

Bin 

Bin 

Bin 

Bin 

Bin 

Bin 

Bin 

Cent. 

Year 

Month 

Day 

Hour 

Min. 

Sec. 

Ints. 


Word 1 


Word 2 


Quad ASCII 


Date 


Century 

Year 

Month 

Day 


Word 1 Word 2 


Time 


Hour 

Minute 

Second 

Interrupt 


Word 3 


Word 4 
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I Compressed Source Format 


Compressed source files are blocked files that consist of 120 byte records. The last 
record may be less than 120 bytes and has a data type code of 9F. The structure of a 
compressed record is described below. 

Each record contains 6 control bytes: 

1 byte data type code, BF (9F indicates last record) 

1 byte byte count, number of data bytes in record 

2 bytes checksum, halfword sum of data bytes 

2 bytes sequence number, record sequence number starting at zero 

Data is recorded as follows: 

1 byte blank count, number of blanks before data 
1 byte data count, number of data bytes 
n-bytes actual ASCII data 

. (this sequence is repeated until the end of a line is reached) 

1 byte EOL character, FF 
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J Map Block Address Assignments 


Map Block # 
Decimal/Hex 

Page # 
Decimal/Hex 

Address Range 
Hexadecimal 

00/00 

00/00 

00000 - 01FFF 

01/01 

04/04 

02000 - 03FFF 

02/02 

08/08 

04000 - 05FFF 

03/03 

12/OC 

06000 - 07FFF 

04/04 

16/10 

08000 - 09FFF 

05/05 

20/14 

OAOOO - OBFFF 

06/06 

24/18 

0C000 - ODFFF 

07/07 

28/1C 

0E000 - OFFFF 

08/08 

32/20 

10000- 11FFF 

09/09 

36/24 

12000 - 13FFF 

10/0 A 

40/28 

14000 - 15FFF 

11/OB 

44/2C 

16000 - 17FFF 

12/0C 

48/30 

18000 - 19FFF 

13/0D 

52/34 

1A000 - 1BFFF 

14/OE 

56/38 

1C000 - 1DFFF 

15/OF 

60/3C 

1E000 - 1FFFF 

16/10 

64/40 

20000 - 21FFF 

17/11 

68/44 

22000 - 23FFF 

18/12 

72/48 

24000 - 25FFF 

19/13 

76/4C 

26000 - 27FFF 

20/14 

80/50 

28000 - 29FFF 

21/15 

84/54 

2A000 - 2BFFF 

22/16 

88/58 

2C000 - 2DFFF 

23/17 

92/5C 

2E000 - 2FFFF 

24/18 

96/60 

30000 - 31FFF 

25/19 

100/64 

32000 - 33FFF 

26/1A 

104/68 

34000 - 35FFF 

27/1 B 

108/6C 

36000 - 37FFF 

28/1C 

112/70 

38000 - 39FFF 

29/1 D 

116/74 

3A000 - 3BFFF 

30/IE 

120/78 

3C000 - 3DFFF 

31/IF 

124/7C 

3E000 - 3FFFF 

32/20 

128/80 

40000 - 41FFF 

33/21 

132/84 

42000 - 43FFF 

34/22 

136/88 

44000 - 45FFF 

35/23 

140/8C 

46000 - 47FFF 

36/24 

144/90 

48000 - 49FFF 

37/25 

148/94 

4A000 - 4BFFF 
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Map Block # 
Decimal/Hex 

Page # 
Decimal/Hex 

Address Range 
Hexadecimal 

38/26 

152/98 

4COOO - 4DFFF 

39/27 

156/9C 

4E000 - 4FFEF 

40/28 

160/A0 

50000 - 51FFF 

41/29 

164/A4 

52000 - 53FFF 

42/2A 

168/A8 

54000 - 55FFF 

43/2B 

172/AC 

56000 - 57FFF 

44/2C 

176/BO 

58000 - 59FFF 

45/2D 

180/B4 

5A000 - 5BFFF 

46/2E 

184/B8 

5C000 - 5DFFF 

47/2F 

188/BC 

5E000 - 5FFFF 

48/30 

192/CO 

60000 - 61FFF 

49/31 

196/C4 

62000 - 63FFF 

50/32 

200/C8 

64000 - 65FFF 

51/33 

204/CC 

66000 - 67FFF 

52/34 

208/D0 

68000 - 69FFF 

53/35 

212/D4 

6A000 - 6BFFF 

54/36 

216/D8 

6COOO - 6DFFF 

55/37 

220/DC 

6E000 - 6FFFF 

56/38 

224/EO 

70000 - 71FFF 

57/39 

228/E4 

72000 - 73FFF 

58/3A 

232/E8 

74000 - 75FFF 

59/3B 

236/EC 

76000 - 77FFF 

60/3C 

240/F0 

78000 - 79FFF 

61/3D 

244/F4 

7A000 - 7BFFF 

62/3E 

248/F8 

7C000 - 7DFFF 

63/3F 

252/FC 

7E000 - 7FFFF 

Extended Memory 128KW to 256KW - IB 


64/40 

256/100 

80000 - FFFFF 

Extended Memory 256KW to 384KW - IB 


128/80 

512/200 

100000 - 17FFFF 

Extended Memory 384KW to 512KW - IB 


192/CO 

768/300 

180000 - 1 FFFFF 

Extended Memory 512KW to 1024KW - IB 


256/100 

1024/400 

200000 - 3FFFFF 

Extended Memory 1024KW to 2048KW - IB 


512/200 

2048/800 

400000 - 7FFFFF 

Extended Memory 2048KW to 4096KW - IB 


1024/400 

4096/1000 

800000 - FFFFFF 
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K Control Switches 


While rebooting the system, various initialization processes can be inhibited or 
enabled by setting the appropriate control switches. The switch assignments are: 

Switch Function if Set 

0 Inhibits volume clean-up by J.MOUNT. 

1 SYSINIT enters the system debugger before processing patches. 

2 Inhibits patch processing (see Reference Manual, Volume III, 

Chapter 9, Entry Conditions). 

3 Inhibits terminal initialization. 

4 Inhibits accounting functions including the M.KEY, M.PRJCT, 

M.ACCNT, and M.ERR files. 

5 Inhibits processing of the sequential task activation table at IPL time. 

6 If J.MOUNT encounters an invalid resource descriptor due to 
an invalid resource descriptor type field or space definition, 

it branches and links to the system debugger (if present) with 
R2 pointing to the resource descriptor. 

7 J.MOUNT prereads the file space bit map (SMAP) or the resource 
descriptor allocation bit map (DMAP). J.MOUNT will not perform file 
overlap protection. 

8 Delete spooled output files instead of resubmitting them for processing. 

9 Inhibits activating LOADACS during EPL or RESTART operations. 

10 Enables faster memory initialization by checking only one location 
per map block to determine if that map block is present. It is not 
recommended that this switch be set on the first IPL after power up. 

1 1 Inhibits initialization of the memory descriptor table (MDT). 

12 For RMSS: inhibits booting of nodes while J.BOOT executes. 

The control switches can be accessed by the console. The proper time to set the 
switches is while the system is waiting for the date and time to be entered. To set, for 
example, switch 3, the following must be entered on the IOP/MFP console: 

ENTER DATE AND TIME: 0@P 
//CS=10000000 Terminal Initialization Inhibited 
/ /@@C 
<CR> 

INVALID DATE FORMAT=MM/DD/XX 
ENTER DATE AND TIME: 

Refer to the CONCEPT 32/2000 Operations manual for instructions for setting control 
switches on the Amiga console. 

During power up, control switches are prezeroed if the proper firmware revision level 
has been installed. Power up without prezeroing can cause unexpected system 
responses due to incorrect control settings. 

All control switch settings are preserved during system reboots not involving system 
power up (i.e., online restart and IPL). 
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L Data Structures 


L.1 Introduction 

This appendix contains some of the more frequently used data structures. Below is a 
list of those structures. 

Caller Notification Packet (CNP) 

Controller Definition Table (CDT) 

Dispatch Queue Entry (DQE) 

File Control Block (FCB), 16 Word 
File Control Block (FCB), 8 Word 
File Control Block (FCB), High Speed Data 
File Pointer Table (FPT) 

Parameter Task Activation Block (PTASK) 

TSM Procedure Call Block (PCB) 

Pathname Blocks (PNB) 

Post Program-Controlled Interrupt Notification Packet (PPCI) 

Parameter Receive Block (PRB) 

Parameter Send Block (PSB) 

Resource Create Block (RCB) 

Resource Identifiers (RID) 

Resource Logging Block (RLB) 

Resource Requirement Summary (RRS) Entries 
Receiver Exit Block (RXB) 

Type Control Parameter Block (TCPB) 

Unit Definition Table (UDT) 
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Caller Notification Packet (CNP) 


L.2 Caller Notification Packet (CNP) 

The caller notification packet (CNP) is the mechanism used by the Resource 
Management Module (H.REMM) and the Volume Management Module (H.VOMM) 
for handling abnormal conditions that may result during resource requests. All or part 
of this structure can be used by a particular service being called. The CNP must be 
on a word boundary. 


WordO 

1 

2 

3-4 

5 


Notes: 

1. A bit sequence and/or value used to provide additional information that can be 
necessary to fully define the calling sequence for a particular service. 

2. A right-justified numeric value identifying the return status for this call. 

3. Refer to the individual system service description in the MPX-32 Reference 
Manual Volume I for interpretation of these words. 


0 


8 


15 16 


23 24 


31 


Time-out value (CP.TIMO) 


Abnormal return address (CP.ABRET) 


Option field (CP.OPTS). See Note 1. Status field (CP.STAT). See Note 2 


Reserved (See Note 3.) 


Automatic open FCB address (CP.FCBA) 
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L.3 Controller Definition Table (CDT) 

The controller definition table (CDT) is a system resident structure used to identify 
information required by handlers and the I/O processor for a specific controller. The 
CDT is built by the SYSGEN process, one for each controller configured on the 
system. The CDT identifies devices (UDTs) associated with the controller, the 
handler address associated with the controller, and defines other pertinent controller 
information. 


0 7 8 15 16 23 24 31 


WordO 

String forward address (CDT.FIOQ) 

1 

String backward address (CDT.BIOQ) 

2 

Link priority 
(CDT.LPRI). 
See Note 1. 

Number of 
entries in list 
(CDT.IOCT). 
See Note 2. 

Class (CDT.CLAS). 
See Note 3. 

Flags (CDT.FLG2). 
See Note 4. 

3 

CDT index (CDT.INDX) 

Device type code 
(CDT.DTC) 

See Note 5. 

Interrupt priority 
level 

(CDT.IPL) 

4 

Number units 
on controller 
(CDT.NUOC) 

Number requests 

outstanding 

(CDT.IORO) 

Channel number 
(CDT.CHAN) 

Subaddress of 
first device 
(CDT. SUB A) 

5 

Program number 
if reserved 
(CDT.PNRC) 

Interrupt handler address (CDT.SIHA) or controller 
information block (CDT.CIF) 

6 

Flags 

(CDT.FLGS). 
See Note 6. 

UDT address of first device on controller 
(CDT.UDTA) 

7 

I/O status 
(CDT.IOST). 
See Note 7. 

TI address (CDT.TIAD) 
or 

SI address if extended I/O (CDT.SIAD) 

8 

UDT address unit 0* (CDT.UTO) 

9-23 

UDT address unit 1* (CDT.UT1) through 
UDT address unit 15* (CDT.UTF) 


* Initialized by SYSGEN 


Notes: 

1. Always zero (head cell) 

2. Number of entries in list (zero if none) 
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3. Values in CDT.CLAS are assigned as follows: 

Value Meaning 

X’OD’ TCW type with extended addressing capability 

X’OE’ TCW type 

X’OF’ extended I/O 

4. Bits in CDT.FLG2 are assigned as follows: 

Bit Meaning if Set 

0 SCSI device (CDT.SCSI) 

1-7 reserved for future use 


5. For example, 01 for any disk, 04 for any tape, etc. Valid device type codes are 
listed in Appendix A. 

6. Bits in CDT.FLGS are assigned as follows: 

Bit Meaning if Set 

0 extended I/O device (CDT.FCLS) 

1 I/O outstanding (set by handler, reset by IOCS) 

(CDT.IOU1) 

2 GPMC device (CDT.GPMC) 

3 initialization (INC) needs to be performed for this 
controller (CDT.FINT) 

4 D-class (CDT.XGPM) 

5 used only when IOQs are linked to the CDT. Set when 
SIO is accepted by the controller. Reset when IOQ is 
unlinked from the CDT or when I/O is reported complete 
to IOCS in the case of operator intervention type errors 
(CDT.IOU5). 

6 IOP controller (CDT.IOP) 

7 controller malfunction (CDT.MALF) 

7. Bits in CDT.IOST are assigned as follows: 

Bit Meaning if Set 

0 IOQ linked to UDT (CDT.NIOQ) 

1 multiplexing controller (CDT.MUXC) 

2 use standard XIO interface 

3 16MB GPMC (CDT.XGPS) 

4 cache controller (CDT.CAC) 

5 H.F8XIO has determined if the controller is 
pre-8512-2 or not (CDT.CKFL) 

6 controller not pre-85 12-2 (CDT.FLOW) 

7 reserved for FMS 


v. 
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L.4 Dispatch Queue Entry (DQE) 

The dispatch queue entry (DQE) contains all of the core-resident information required 
to describe an active task to the system. It is always linked to the CPU scheduler 
state chain that describes the current execution status of the associated task. 


Word No. 
(Decimal) 

Byte 

(Hex) 

0 7 

8 15 

16 23 

24 31 

0 

0 

DQE.SF 

1 

4 

DQE.SB 

2 

8 

DQE. CUP 

DQE.BUP 

DQE.IOP 

DQE.US 

3 

C 

DQE.NUM/DQE.TAN 

4-5 

10 

DQE.ON 

6-7 

18 

DQE.LMN 

8-9 

20 

DQE.PSN 

10 

28 

DQE.USW 

11 

2C 

DQE.USHF 

12 

30 

dqe.msd 

13 

34 

DQE.KCTR 

14 

38 

DQE.MMSG 

DQE.MRUN 

DQE.MNWI 

DQE.GQFN 

15 

3C 

DQE.UF2 

DQE.IPUF 

DQE.NWIO 

DQE.SOPO 

16 

40 

DQE.CQC 

17 

44 

DQE.SH 

DQE.SHF 

DQE.TIFC 

DQE.RILT 

18 

48 

DQE .UTS 1 

19 

4C 

DQE.UTS2 

20 

50 

DQE.DSW 

21 

54 

DQE.PRS 

22 

58 

DQE.PRM 

23 

5C 

Reserved 

DQE.TSKF 

DQE.MSPN 

DQE.MST 

24 

60 

DQE.PSSF 

25 

64 

DQE.PSSB 

26 

68 

DQE.PSPR 

DQE.PSCT 

DQE.ILN 

DQE.RESU 

27 

6C 

DQE.TISF 

28 

70 

DQE.TISB 

29 

74 

DQE.TIPR 

DQE.TICT 

DQE.SWIF 

DQE.UBIO 

30 

78 

DQE.RRSF 

31 

1C 

DQE.RRSB 

32 

80 

DQE.RRPR 

DQE.RRCT 

DQE.NSCT 

33 

84 

DQE.MRSF 

34 

88 

DQE.MRSB 
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Word No. 
(Decimal) 

Byte 

(Hex) 

0 7 

8 15 

16 23 

24 31 

35 

8C 

DQE.MRPR 

DQE.MRCT 

DQE.NWRR 

DQE.NWMR 

36 

90 

DQE.RTI 

DQE.NWLM 

DQE.ATI 

Reserved 

37 

94 

DQE.S AIR/DQE.TAD 

38-40 

98 

DQE.ABC 

41 

A4 

DQE.TSAP 

4243 

A8 

DQE.SRID/DQE.PGOL 


AC 

DQE.SRID/DQE.PGOC 

DQE.SRID/Reserved 

44-51 

BO 

DQE.CDIR/DQE.CVOL 

52 

DO 

DQE.GID 

Reserved 

DQE.ASH 

53 

D4 

DQE.ACX2 

54 

D8 

DQE.MRQ 

DQE.MEM 

DQE.MEMR 

55 

DC 

DQE.MRT 

Reserved 

DQE.RMMR 

56 

E0 

DQE.MAPN 

DQE.CME 

57 

E4 

DQE.CMH 

DQE.CMS 

58-63 

FC 

Reserved 

Byte 

(Hex) 

Symbol 

Description 



0 

DQE.SF 

String forward linkage address; 

Field length = 1W; 

Standard linked list format; 

Contains address of next (top-to-bottom) 

entry in chain. 

4 

DQE.SB 

String backward linkage address; 



Field length = 1W; 

Standard linked list format; 

Contains address of next (bottom-to-top) entry in chain. 


8 DQE. CUP Current user priority; 

Standard linked list format; 

This priority is adjusted for priority migration based on 
situational priority increments. Situational priority 
increments are based on the base level priority 
(DQE.BUP) of the task. 


DQE.BUP Base priority of user task; 

Field length = IB; 

Used by scheduler to generate DQE.CUP (current priority) 
based on any situational priority increments. 

DQE.IOP I/O priority; 

Field length = IB; 

Initially set from base priority; 

Used for I/O queue priority. 
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Byte 

(Hex) Symbol Description 

DQE.US State chain index for this user task; 

Field length = IB; 

Range: zero through X’lE’; 

Indicates current state of this task, such as ready-to-run 
priority, I/O wait, resource block, etc. 


Label 

Index 

Task description 

FREE 

00 

DQE is available (in free list) 

PREA 

01 

activation in progress 

CURR 

02 

currently executing task or is pre-empted 
time-distribution task in quantum stage one 

SQRT 

03 

ready to run (priority level 1 to 54) 

SQ55 

04 

ready to run (priority level 55) 

SQ56 

05 

ready to run (priority level 56) 

SQ57 

06 

ready to run (priority level 57) 

SQ58 

07 

ready to run (priority level 58) 

SQ59 

08 

ready to run (priority level 59) 

SQ60 

09 

ready to run (priority level 60) 

SQ61 

0A 

ready to run (priority level 61) 

SQ62 

0B 

ready to run (priority level 62) 

SQ63 

OC 

ready to run (priority level 63) 

SQ64 

0D 

ready to run (priority level 64) 

SWTI 

0E 

waiting for terminal input 

SWIO 

OF 

waiting for I/O 

SWSM 

10 

waiting for message complete 

SWSR 

11 

waiting for run request complete 

SWLO 

12 

waiting for low speed output 

SUSP 

13 

waiting for timer expiration, resume 
request, or message interrupt 

RUNW 

14 

waiting for timer expiration, or run request 

HOLD 

15 

waiting for a continue request 

ANYW 

16 

waiting for timer expiration, no-wait I/O 
complete, no- wait message complete, no-wait 
run request complete, message interrupt, 
or break interrupt 

SWDC 

17 

waiting for disk space 

SWDV 

18 

waiting for device allocation 

SWFI 

19 

waiting for file system 

MRQ 

1A 

waiting for memory 

SWMP 

IB 

waiting for memory pool 

SWGQ 

1C 

waiting in general wait queue 

CIPU 

ID 

current IPU task in execution 

RIPU 

IE 

IPU requesting state 
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Byte 

(Hex) Symbol Description 


C 


10 

18 

20 


28 

2C 


DQE.NUM 


DQE.TAN 


DQE.ON 

DQE.LMN 

DQE.PSN 


DQE.USW 

DQE.USHF 


DQE entry number, 

Field length = IB; 

Used as an index to DQE address table (DAT); 

Range: one through "N"(for MPL index compatibility); 
Used by scheduler to set C.PRNO to reflect 
the currently executing task. This value is also 
used as the MPL index. It is used by the scheduler 
to initialize the CPIX in the PSD before loading the 
map for this task. 

Task activation sequence number, 

Field length = 1W; 

This number is assigned by the activation service 
and uniquely identifies a task. 

Note: The most significant byte of this value 
is the DQE entry number and is accessible as 
DQE.NUM. 

Owner name; 

Field length = ID. 

Load module name; 

Field length = ID. 

Pseudonym associated with task; 

Field length = ID; 

This parameter is an optional argument accepted by the 
pseudo task activation service. It can be used to 
uniquely identify a task within a subsystem, such as 
multibatch. It contains descriptive information useful 
to the system operator or to other tasks within a 
subsystem. Conventions used to generate a pseudonym 
are determined by the associated subsystem. 

A system-wide convention should be used to establish 
pseudonym prefix conventions to avoid confusion 
between subsystems. 

User status word; 

Field length = 1W. 

Scheduling flags; 

Field length = 1W; 

Used by the scheduler to indicate special status 
conditions. 
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Byte 

(Hex) Symbol Description 

Bit Meaning When Set 

00 load protection image requested (DQE.LPI) 

01 single copy load module (DQE.SING) 

02 task is indirectly connected (DQE.INDC) 

03 task is privileged (DQE.PRIV) 

04 task has message receiver (DQE.MSGR) 

05 task has break receiver (DQE.BRKR) 

06 task quantum stage one expired (DQE.QS1X) 

07 task quantum stage two expired (DQE.QS2X) 

08 in-swap I/O error (DQE.INER) 

09 wait I/O request outstanding (DQE.WIOA) 

10 wait I/O complete before in-progress notification 
(DQE.WIOC) 

1 1 inhibit message pseudointerrupt (DQE.INMI) 

12 batch origin task (DQE.BAOR) 

13 running in TSM environment (DQE.TMOR) 

14 task abort in progress (DQE.ABRT) 

15 task is in pre-exit state (DQE.PRXT) 

16 run receiver mode (DQE.RRMD) 

17 wait send message outstanding (DQE.WMSA) 

18 wait message complete before link to wait 
queue (DQE.WMSC) 

19 wait mode send run request outstanding 
(DQE.WRRA) 

20 wait mode send run request complete before 
link to wait queue (DQE.WRRC) 

21 debug associated with task (DQE.DBAT) 

22 real-time task (DQE.RT) 

23 time-distribution task initial dispatch (DQE.TDID) 
Set by: 

• H.ALOC1 on activation of T/D task. 

• S.EXEC5 1 when task is linked to wait state. 

• H.EXEC7 on completion of inswap or other 
memory request. 

Reset by: 

• S.EXEC20 on initial dispatch of task after 
activation 

• Wait state termination 

• In-swap 

24 task delete in progress (DQE.DELP) 

25 task abort (with abort receiver) in progress 
(DQE.ABRA) 

26 abort receiver established (DQE.ABRC) 

27 asynchronous abort/delete inhibited 
(DQE.ADIN) 

28 asynchronous delete deferred (DQE.ADDF) 

29 task is inactive (DQE.INAC) 

30 asynchronous abort deferred (DQE.AADF) 

31 activation timer in effect (DQE. ACTT) 
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Byte 

(Hex) 

Symbol 

Description 

30 

DQE.MSD 

Physical address of MIDL in TSA; 
Field length = 1W. 

34 

DQE.KCTR 

Kill/abort timer; 
Field length = 1W. 

38 

DQE.MMSG 

Maximum number of no wait messages 
allowed to be sent by this task; 

Field length = IB. 


DQE.MRUN 

Maximum number of no-wait run requests allowed 
to be sent by this task; 

Field length = IB. 


DQE.MNWI 

Maximum number of no- wait I/O requests allowed 
to be concurrently outstanding for this task; 

Field length = IB. 


DQE.GQFN 

Contains the generalized queue (SWGQ) 


function code; 

Field length = IB; 

Function codes are queued as follows: 


Code 

Meaning 

01 

volume resource (QVRES) 

02 

ART space (QART) 

03 

mount in progress (QMNT) 

04 

resourcemark lock (QRSM) 

05 

reserved for eventmark (QEVM) 

06 

read wait for writer (QGEN) 

07 

shared memory table (QSMT) 

08 

synchronous resource lock (QSRL) 

09 

mounted volume table (QMVT) 

0A 

dual-port lock (QDPLK) 

0B 

suspend dual-port lock (QSUSP) 

OC 

debug wait (QDBGW) 

0D 

remote message area (QMSG) 

0E 

remote message event (QSER) 

OF 

remote allocate area (QASMP) 

10 

remote deallocate area (QDSMP) 

11 

remote abort area (QAMSG) 

12 

remote enable/disable area (QOMSG) 

13 

wait for TSM (QWTSM) 
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DQE.UF2 


Description 

Scheduling flags; 
Field length = IB; 


DQE.IPUF 


Meaning if Set 

enable debug mode break (DQE.EDB) 
generalized wait queue time-out (DQE.GQTO) 
task interrupts are synchronized (DQE.SYNC) 
task is part of a job (DQE.JOB) 

ACX-32 task flag (DQE.ACX) 

special arithmetic function requested (DQE.AF) 

reserved 

run request terminated (DQE.RRT) 


IPU flag byte; 
Field length = IB; 


Meaning if Set 

IPU inhibit flag (DQE.IPUH) 

IPU bias flag (DQE.IPUB) 

CPU only (DQE.IPUR) 

OS execution direction flag (set when PSD 
is in user area) (DQE.OSD) 
base register task (DQE. BASE) 

Ada task (DQE.ADA) 

PTRACE debugger task (DQE.PDBG) 
H.PTRAC task association control bit 
(DQE.PTRA) 


DQE.NWIO 


DQE.SOPO 


Number of no-wait I/O requests; 

Field length = IB. 

Priority bias only swapping control flags; 

Field length = IB; 

Bit Meaning if Set 

0 SWGQ state priority-based swapping 
(DQE.GQPO) 

1 swap inhibit due to bit map access 
(DQE.BMAP) 

2 inhibit swap device while accessing MDT 
(DQE.MDTA) 

3 user swap inhibit flag (DQE.USWI) 

4 user swap on priority only flag (DQE.USPO) 

5-7 reserved 
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Byte 

(Hex) Symbol 

40 DQE.CQC 


44 DQE.SH 

DQE.SHF 


DQE.TIFC 


Description 

Current quantum count; 

Field length = 1W; 

Used by the scheduler to accumulate elapsed execution 
time for the task to compare the level unique 
stage one and stage two time-distribution values. 

Used by J.SWAPR to swap shadow memory; 

Field length = IB. 

Shadow memory flag; 

Field length = IB; 

Bit Meaning if Set 

0 task requests shadow memory (DQE.SHAD) 

1 IPU shadow memory requested (DQE.SHI) 

2 IPU/CPU Common Shadow Memory 
requested (DQE.SHB). 


Timer function code; 

Field length 

= IB; 

Value 

Meaning 

00 

not active 

01 

request interrupt 

02 

resume program from suspend (SUSP) 
queue 

03 

resume program from any-wait (ANYW) 
queue 

04 

resume program from run-request-wait 
(RUNW) queue 

05 

resume program from generalized 
(SWGQ) queue 

06 

resume program from peripheral device 
(SWDV) queue 

07 

resume program from disk space (SWDC) 
queue 


48 


DQE.RILT 


DQE.UTS1 


Request Interrupt (RI) level for timer. 

Field length = IB; 

Identifies the interrupt level to be requested upon 
timer expiration. 


User timer slot word 1; 

Field length = 1W; 

Current timer value; 

Contains negative number of timer units before 
time out. 
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Byte 


(Hex) 

Symbol 

Description 

4C 

DQE.UTS2 

User timer slot word 2; 

Field length = 1W; 

Reset timer value; 

Contains negative number of timer units; 
Used to reset the current timer value when 
it expires. 

50 

DQE.DSW 

Base mode debugger status word (PCALL); 
Field length = 1W. 

54 

DQE.PRS 

Peripheral requirement specification; 


Field length = 1W; 


58 


5C 


DQE.PRM 


Reserved 

DQE.TSKF 


Bit Description 

0-7 reserved 

8-15 device type code 

16-23 channel address 

24-31 subchannel address or contains first 

word of SWGQ ID. 

Peripheral requirements mask; 

Field length = 1W; 


Value 


Meaning 


X’OOFFOOOO’ any device of this type code 

X’OOFFFFOO’ any device of the specified type 
code on the specified channel 
X’OOFFFFFF’ the specified device as described 
by type code, channel, and 
subchannel address, or contains 
second word of SWGQ ID. 


Field length = IB 

Task flags; 

Field length = IB; 

Bit Meaning if Set 

0 real-time accounting disabled 

(DQE.RTAC) 

1-2 reserved for RMSS 

3 task is running with MPX-32 mapped out 
(DQE.MAPO) 

4 reserved for MPX-32 

5 task is demand paged (DQE.DPG) 

6 inhibit page out (DQE.NPGO) 

7 reserved 
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Byte 

(Hex) Symbol 

DQE.MSPN 

DQE.MST 


Description 

TSA maps required to span MIDLs and MEMLs; 
Field length = IB. 

Static memory type specification; 

Field length = IB; 

Value Memory Class 


01 

E 

02 

H 

03 

S 

04 

HI 

05 

H2 

06 

H3 


60 


64 


68 


DQE.PSSF 


DQE.PSSB 


DQE.PSPR 


DQE.PSCT 


DQE.ILN 


DQE.RESU 


This field is used to specify the type 
of memory required for in-swap. 

Pre-emptive system service head cell string 
forward linkage address; 

Standard head cell format; 

Field length = 1W; 

Contains address of next (top-to-bottom) entry in chain. 

Pre-emptive system service head cell string 
backward linkage address; 

Standard head cell format; 

Field length = 1W; 

Contains address of next (bottom-to-top) entry in chain. 

Pre-emptive system service head cell dummy 
priority (always zero); 

Standard head cell format; 

Field length = IB. 

Pre-emptive system service head cell number of 
entries in list; 

Standard head cell format; 

Field length = IB. 

Interrupt level number; 

Field length = IB; 

Identifies associated interrupt level for interrupt 
connected tasks. 

Reserved usage index; 

Field length = IB. 


V,-'- 


■ 
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Byte 

(Hex) 

6C 


70 


74 


78 


7C 


80 


Symbol 

DQE.TISF 

DQE.TISB 

DQE.TIPR 

DQE.TICT 

DQE.SWIF 


DQE.UBIO 

DQE.RRSF 

DQE.RRSB 

DQE.RRPR 


Description 

Task interrupt head cell string forward linkage address; 
Standard head cell format; 

Field length = 1W; 

Contains address of next (top-to-bottom) entry in chain. 

Task interrupt head cell string backward linkage address; 
Standard head cell format; 

Field length = 1W; 

Contains address of next (bottom-to-top) entry in chain. 

Task interrupt head cell dummy priority (always zero); 
Standard head cell format; 

Field length = IB. 

Task interrupt head cell number of entries in list; 
Standard head cell format; 

Field length = IB. 

Swapping inhibit flags; 

Field length = IB; 

Bit Task Meaning if Set 

0 resident (DQE.RESP) 

1 locked in memory (DQE.LKIM) 

2 unbuffered I/O in progress (DQE.IO) 

3 outswapped (DQE.OTSW) 

4 leaving system (DQE.TLVS) 

5 forced unswappable during terminal output 
(DQE.FCUS) 

6 forced unswappable because swap file has 
not been allocated for it (DQE.FCRS) 

7 imbedded in the operating system 
(DQE.INOS) 

Number of unbuffered I/O requests currently outstanding; 
Field length = IB. 

Run receiver head cell string forward linkage address; 
Standard head cell format; 

Field length = 1W; 

Contains address of next (top-to-bottom) entry in chain. 

Run receiver head cell string backward linkage address; 
Standard head cell format; 

Field length = 1W; 

Contains address of next (bottom-to-top) entry in chain. 

Run receiver head cell dummy priority (always zero); 
Standard head cell format; 

Field length = IB. 
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Byte 

(Hex) Symbol 

DQE.RRCT 

DQE.NSCT 
84 DQE.MRSF 

88 DQE.MRSB 

8C DQE.MRPR 


DQE.MRCT 


DQE.NWRR 
DQE.NWMR 
90 DQE.RTI 


Description 

Run receiver head cell number of entries in list; 

Standard head cell format; 

Field length - IB. 

Number of map blocks outswapped; 

Field length = 1H. 

Message receiver head cell string forward 
Linkage address; 

Standard head cell format; 

Field length = 1W; 

Contains address of next (top-to-bottom) entry in chain. 

Message receiver head cell string backward 
Linkage address; 

Standard head cell foimat; 

Field length = 1W; 

Contains address of next (bottom-to-top) entry in chain. 

Message receiver head cell dummy priority (always zero); 
Standard head cell format; 

Field length = IB. 

Message receiver head cell number of entries in list; 
Standard head cell format; 

Field length = IB. 

Number of no-wait mode run requests outstanding; 

Field length = IB. 

Number of no-wait mode message requests outstanding; 
Field length = IB. 

Requested task interrupt flags; 

Field length = IB; 

Bit Meaning if Set 

0 reserved 

1 priority one end action request. Used for 
pre-emptive system services. (DQE.EA1R) 

2 debug break request (DQE.DBBR) 

3 user break request (DQE.UBKR) 

4 priority two end action request (DQE.EA2R) 

5 message interrupt request (DQE.MSIR) 

6-7 reserved 
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Byte 

(Hex) Symbol Description 


DQE.NWLM 

DQE.ATI 


Reserved 

94 DQE.SAIR 



DQE.TAD 

98 

DQE.ABC 

A4 

DQE.TSAP 

A8-AC 

DQE.SRID 


DQE.PGOL 


DQE.PGOC 

Reserved 


No-wait run request limit. 

Field length = IB. 

Active task interrupt flags; 

Field length = IB; 

Bit Meaning if Set 

0 reserved 

1 priority one active end action (DQE.AEA1) 

2 active debug break (DQE.ADM) 

3 active user break (DQE.AUB) 

4 priority two active end action (DQE.AEA) 

5 active message interrupt (DQE.AMI) 

6-7 reserved 

Field length = IB. 

System action task interrupt request; 

Bit Meaning if Set 

0 request for delete of this task (DQE.DELR) 

1 reserved 

2 hold task request (DQE.HLDR) 

3 abort task request (DQE.ABTR) 

4 exit task request (DQE.EXTR) 

5 suspend task request (DQE.SUSR) 

6 run receiver mode request (DQE.RRRQ) 

7 reserved 

TSA address (logical); 

Field length = 1W; 

Byte zero contains DQE.SAIR. 

Abort code; 

Field length = 3W. 

Physical address of the TSA 

If DQE.DPG is reset; 

Used swap space linked list; 

Field length = 2W. 

If DQE.DPG is set; 

Forward pointer to MPTL (MAP.SF); 

Field length = 1HW 

Backward pointer to MPTL (MAP.SB) 

Field length = 1HW 

Number of pages queued for pageout 
Field length = 1HW 

Field length = 1HW 
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Byte 

(Hex) Symbol Description 


BO 


DO 

D1 

D2 

D4 

D8 


DC 


DQE.CDIR 

DQE.CVOL 

DQE.GID 

Reserved 

DQE.ASH 

DQE.ACX2 

DQE.MRQ 

DQE.MEM 


DQE.MEMR 

DQE.MRT 


Load module RID at activation; 

Field length = 8W. 

Current working volume at activation; 

Field length = 8W. 

Group swap identification; 

Field length = IB. 

1 Byte 

Number of shadow memory blocks currently allocated 
Field length = 1H. 

Advance communication word; 

Field length = 1W. 

Memory request doubleword; 

Reserved field length = IB. 

Type of memory requested; 

Field length = IB; 


Value 

Memory Class 

01 

E 

02 

H 

03 

S 

Number of memory blocks required; 

Field length 

= 1H. 

Memory request type code; 

Field length 

= IB; 

Value 

Meaning 

00 

in-swap only 

01 

preactivation request 

02 

activation request 

03 

memory expansion request 

04 

IOCS buffer request 

05 

shared memory request 

06 

system buffer request 

07 

release swap file space 


If DQE.MRT equals 05, the next three bytes will 
contain the address of the shared memory table entry. 




Reserved 


Field length = IB. 


DQE.RMMR 


Map register for requested memory; 
Field length = 1H. 
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Dispatch Queue Entry (DQE) 


Byte 

(Hex) Symbol Description 


EO 


E4 


E8 


DQE.MAPN 

DQE.CME 


DQE.CMH 


DQE.CMS 


Reserved 


Inclusive span of maps in use; 

Field length = 1H. 

Number of swappable class E map blocks 
currently allocated; 

For resident tasks, if not zero, reflects the 
total number of map blocks in use. 

Field length = 1H. 

Number of swappable class H map 
blocks currently allocated; 

For resident tasks, if not zero, reflects the 
total number of map blocks in use. 

Field length = 1H. 

Number of swappable class S map blocks 
currently allocated; 

For resident tasks, if not zero, reflects the 
total number of map blocks in use. 

Field length = 1H. 

Reserved for MPX-32 
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File Control Block (FCB), 16 Word 


L.5 File Control Block (FCB), 16 Word 


Wad 0 7 8 12 13 31 


0 

Opcode 
: {FCB.OPCD) 

Logical file code (FCB .LFC) 

1 

Reserved 

2 

General control 
flags 

(FCB.GCFG) 

Special flags 
(FCB.SCFG) 

Reserved 

3 

Status flags (FCB.SFLG) 

4 

Actual transfer quantity (FCB.RECL) \ 

5 

Reserved 

I/O queue address (FCBJOQA) 

6 

Special Status 
(FCB.SPST) 

Wait I/O error return address (FCB.ERRT) 

7 

liiiiililiiil 

(FCB.EPTt) 

FAT address (FCB.FATA) 

8 

: Reserved 

I/O buffer address (FCB.ERWA) 

9 

Transfer quantity (bytes) (FCB.EQTY) 

10 

Random access address (FCB.ERAA) 

11 

?:Rxteind^d ? ;|^ . status ' word one ''(!PCB,1ST |||| 

12 

Extended I/O status word two (FCBJST2) 

13 

Reserved 

No-wait I/O normal end-action service address (FCB.NWOK) 

14 

Reserved 

No-wait I/O error end-action service address (FCB.NWER) 

15 

Number of 

buffers 

(FCB.BBN) 

Address of blocking buffer (FCB.BBA) 


Shaded areas are set by the system. T1FCB 

Word 0 

Bit 0 Reserved 

Bits 1-7 Operation code (FCB.OPCD) — type of function requested of the device 
handler. This field is set by IOCS as a function of the executed service. 

Bits 8-31 Logical file code (FCB.LFC) — any combination of three ASCII 

characters is allowed. The LFC must match the previously assigned LFC 
of the I/O resource being accessed. 

Word 1 

Bits 0-31 Reserved 
Word 2 

Bits 0-7 General control flags (FCB.GCFG) — these eight bits enable the user to 
specify the manner in which an operation is to be performed by IOCS. 

The interpretation of these bits is shown as follows: 
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File Control Block (FCB), 16 Word 


Bit 

0 


1 


2 

3 


4 


5 

6 
7 


Meaning 

if Set Definition 

NWT IOCS returns to the user immediately after the 

I/O operation is queued. If reset, IOCS exits to the 
calling program only when the requested operation 
has been completed. 

NER error processing is not performed by either the device 

handler or IOCS. An error return address is ignored 
and a normal return is taken to the caller; however, 
the device status is posted in the FCB unless bit 
3 is set. If reset, normal error recovery is 
attempted. Normal error processing for disk and 
magnetic tape is automatic error retry. Error 
processing for unit record devices except the 
system console is accomplished by IOCS typing 
the message INOP to the console, which allows 
the operator to retry or abort the I/O operation. 

If the operator aborts the I/O operation, or if 
automatic error retry for disk or magnetic tape is 
unsuccessful, an error status message is typed 
to the console and the error return address is 
taken if provided. Otherwise, the task is aborted. 

DFI data formatting is inhibited. Otherwise, data 

formatting is performed by the appropriate device 
handler. See Table L-l for more explanation. 

NST device handlers perform no status checking and no 

status information is returned. All I/O appears 
to complete without error. Otherwise, status 
checking is performed and status information 
is returned as necessary. 

RAN file accessing occurs in the random mode. 

Otherwise, sequential accessing is performed. 

Note: This bit is set if word 2 bit 12 is set. 

reserved (M.FILE) 

EXP must be 1 for 16-word FCB. 

EEC this bit is reserved for internal IOCS use. 


Bits 8-12 Special Control Specification (FCB.SCFG). — This field 

contains device control specifications unique to certain devices. 
Interpretation and processing of these specifications are performed 
by the device handlers. A bit setting is meaningful only when a 
particular type of device is assigned as indicated in Table L-l. 

Bits 13-31 reserved for extended control specifications 
Meaning 

Bit if Set Definition 

13 RXON software read flow control required 

for 8-Line ACM (FCB .RXON) 
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File Control Block (FCB), 16 Word 


Table L-1 

Special Control Flags 


Device 

Bit 2=0 

Bit 2=1 

Bit 8=0 

Bit 8=1 

Bit 9=0 

Bit 9=1 

Line 

Printer 

(LP) 

Interpret first 
character as 
carriage 
control 

Interpret first 
character as 
data 

See bit 8 

Form 

control 

No form 
control 



Discs, 

(DM,DF, 

FL) 

Report EOF if 
X’OFEOFEOF’ 
encountered 
in word 0 of 
1st block 
during read 
of unblocked 
file 

X’OFEOFEOF’ 
in word 0 
not 

recognized 
as EOF 





8 -Line 

Asynchronous 

Communications 

Multiplexer 

(TY) 

M.READ 

M.READ 

M.READ 

M.READ 

M.READ 

M.READ 

Perform 

special 

character 

formatting 

No special 

character 

formatting 

ASCII control 
passed as 
data 

ASCH control 

character 

detect 

Echo by 
controller 

No echo by 
controller 


M.WRIT 

M.WRIT 

SVC 1,X’3E’ 

SVC 1,X’3E* 

M.WRIT 

M.WRIT 


Interpret first 
character as 
carriage 
control 

Interpret first 
character as 
data 

Stop 

transmitting 

break 

Start 

transmitting 

break 

Normal 

write 

Initialize 
device (load 
UART 
parameters) 


Device 

Bit 10=0 

Bit 10=1 

Bit 11=0 

Bit 11=1 

Bit 12=0 

Bit 12=1 

Line Printer (LP) 

Reserved 

Reserved 

Reserved 

Reserved 

Reserved 

Reserved 

Discs, 

(DM,DF, 

FL) 





Normal read 

Read with byte 
granularity 
(word 2 bit 
4 set) 

8 -Line 

Asynchronous 

Communications 

Multiplexer 

(TY) 

M.READ 

M.READ 

M.READ 

M.READ 

M.READ 

M.READ 

(If bit 2=0) 
convert lower 
case 

character 
to upper case 

Inhibit 

conversion 

No special 

character 

detect 

Special 

character 

detect 

Do not purge 
type ahead 
buffer 

Purge type 
ahead buffer 


M.WRIT 

M.WRIT 

M.WRIT 

M.WRIT 

M.WRIT 

M.WRIT 




Normal write 

Write with 
input sub- 
channel 
monitoring 
plus software 
flow control 




Continued on next page 
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File Control Block (FCB), 16 Word 


Table L-1 

Special Control Flags ( Continued ) 


Device 

(Bit 2=0) 

(Bit 2=1) 

Bit 8 

Bit 9 


Bit 10 

Bit 11 

Bit 12 

ALIM 

Read: 

Bit 2 

Bit 8 

Bit 9 

Read 

On Read: 



(Asynch- 

receive 








ronous 

data 

0 

1 

0 

=Blind mode reset 

1= Inhibit 



Line 

(bytes) 

0 

0 

1 

=Echo on read 

conversion 



Interface 

defined 

1 

N/A 

N/A 

=Receive data 

of lower 



Module) 

for 

0 

0 

0 

=Receive data 

case 



Terminals 

transfer 





characters 



(TV) 

count 





to upper 








Write 

case 




Write: 

0 

N/A 

0 

=Formatted write 

0= Convert 




formatted 

0 

N/A 

1 

initialize device 






1 

N/A 

N/A 

Unformatted write 
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File Control Block (FCB), 16 Word 


Word 3 

Bits 0-31 


Word 4 

Bits 0-31 


Status word (FCB.SFLG) — 32 indicator bits are set by IOCS to 
indicate the status, error, and abnormal conditions detected 
during the current or previous operation. The assignment of 
these bits is shown as follows: 


Meaning 


Bits 

if Set 

Definition 

0 

OP 

operation in progress. Request has 
been queued. (Note: Reset after post I/O 
processing complete.) 

1 

ERR 

error condition found 

2 

BB 

invalid blocking buffer control pointers 
have been encountered during file blocking 
or unblocking 

3 

PRO 

write protect violation 

4 

INOP 

device inoperable 

5 

BOM 

beginning-of-medium (BOM) Goad point) 
or illegal volume number (multivolume 
magnetic tape) 

6 

EOF 

end-of-file 

7 

EOM 

end-of-medium (end of tape, end of 
disk file) 

8-9 


reserved 

10 

TIME 

last command exceeded time-out value 
and was terminated 

11-15 


reserved 

16 

ECHO 

echo 

17 

INT 

post program-controlled interrupt 

18 

LEN 

incorrect length 

19 

PROG 

channel program check 

20 

DATA 

channel data check 

21 

CTRL 

channel control check 

22 

INTF 

interface check 

23 

CHAI 

chaining check 

24 

BUSY 

busy 

25 

ST 

status modified 

26 

CTR 

controller end 

27 

ATTN 

attention 

28 

CHA 

channel end 

29 

DEV 

device end 

30 

CHK 

unit check 

31 

EXC 

unit exception 


Record length (FCB.RECL) — this field is set by IOCS to indicate the 
actual number of bytes transferred during read/write operations. 
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Word 5 

Bits 0-7 Reserved 

Bits 8-31 I/O queue address (FCB.IOQA) — this field is used by IOCS to point 
to the I/O queue for an I/O request initiated from this FCB 

Word 6 

Bits 0-7 Special status bits (FCB.SPST). The interpretation 
of these bits is shown below: 

Bits Definition 

0 no-wait normal end action not taken 

1 no-wait error end action not taken 

2 request killed, I/O not issued 

3 if set, exceptional condition has occurred in the 
I/O request 

4 if set, software read flow control required 

5-7 reserved 


Bits 8-31 Wait I/O error return address (FCB.ERRT) — this field is set by the 
user and contains the address to which control is to be transferred 
in the case of an unrecoverable error when control bits 1 and 3 
of word 2 are reset. If this field is not initialized and an 
unrecoverable error is detected under the above conditions, the 
requesting task is aborted. 

Word 7 

Bits 0-7 Index to FPT (FCB.FPTI) — this field is set by IOCS to index into the 
associated entry in the file pointer table (FPT) 

Bits 8-31 FAT address (FCB .FATA) — this field is set by IOCS to point to the 
associated file assignment table (FAT) entry. 

Word 8 

Bits 0-7 Reserved 

Bits 8-31 Data buffer address (FCB.ERWA) — start address of data area 
for read or write operations. (24 bit pure address) 

Word 9 

Bits 0-31 Quantity (FCB.EQTY) — number of bytes of data to be transferred 
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File Control Block (FCB), 16 Word 


Word 10 

Bits 0-31 Random access address (FCB.ERAA) — this field contains a 
block number (zero origin) relative to the beginning of the 
disk file. It is the start address for the current read or 
write operation with word 2 bit 4 set and word 2 bit 12 reset. 

or 

For disk read requests with word 2 bits 4 and 12 set (read with 
byte granularity), this word defines the byte offset relative to the 
beginning of the file. Note: If word 9 is zero, the file retains 
its position prior to the call. 

Word 11 

Bits 0-31 Status word one (FCB.IST1) — these are the first 32 bits 
of status returned by the sense command 

Word 12 

Bits 0-31 Status word two (FCB.IST2) — these are the second 32 bits 
of status returned by the sense command 

Word 13 

Bits 0-7 Reserved 

Bits 8-31 No-wait I/O (FCB.NWOK) — normal completion return address. 

This user routine must be exited by calling the M.XIEA service. 

Word 14 

Bits 0-7 Reserved 

Bits 8-31 No-wait I/O (FCB.NWER) — error completion return address. 

This user routine must be exited by calling the M.XIEA service. 

Word 15 (Applicable only to volume resource.) 

Bits 0-7 (FCB.BBN) — Number of 192 word buffers for user supplied blocking 
buffers. A value of one or zero in this field specifies one 
blocking buffer. 

Bits 8-31 Blocking buffer address (FCB.BBA) — starting address 
of a contiguous area of memory FCB.BBN buffers long 


' 

\._.y 
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File Control Block (FCB), 16 Word 


Table L-2 

Device Functions (Standard Devices) 


IOCS Line Disk 

Op Printer Mag Tape (DM/DF/ Handler=F8XIO 

Operation Code (LP) (M9/MT) DC/Floppy) (8-Line) 

Open 

(M.FILE) 

0 

IOCS 

opens 

IOCS opens 

IOCS opens 

Initialize IOP 
channel if 
necessary 

Rewind 

(M.RWND) 

1 

Eject,set 
BOM bit 
word 3 bit 5 
in FCB 

Rewind Tape 

Set current 
block address 
to zero (FAT) 

SENSE operation 

Read Record 
(M.READ) 

2 

Spec error 

Read to data 
buffer 

Read to data 
buffer 

Read to data 
buffer 

Write record 
(M.WRIT) 

3 

Write from 
data buffer 

Write from 
data buffer. 
If blocked 
writes n 
data buffers 
to blocking 
buffer before 
output 

Write from 
data buffer. 

If blocked IOCS 
writes n 
data buffers 
to blocking 
buffer before 
output 

Write record to 
terminal 

Write EOF 
(M.WEOF) 

4 

NOP* 

Write EOF 

If blocked, 
IOCS writes 
EOF. If 
unblocked 
writes 

X’OFEOFEOF’ 

NOP* 

Execute 

Channel 

5 

Spec error 

Execute 

Channel 

Program 

Execute 

Channel 

Program 

Execute channel 
Program 


*NOP — No operation performed 
Continued on next page 
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File Control Block (FCB), 16 Word 


Table L-2 

Device Functions (Standard Devices) (Continued) 


IOCS Line Disk 

Op Printer Mag Tape (DM/DF/ Handler=F8XIO 

Operation Code (LP) (M9/MT) DC/Floppy) (8-Line) 

Advance 

Record 

(M.FWRD) 

6 

Spec error 

Advance 

record 

If blocked, 
advance 
record. If 
unblocked, 
advance one 
192W block. 

Set data terminal 
ready 

Advance 

File 

(M.FWRD) 

7 

Spec error 

Advance file 
(past EOF) 

Spec error 

Reset data 
terminal ready 

Backspace 

Record 

(M.BACK) 

8 

Spec error 

Backspace 

record 

If blocked, 

backspace 

record. If 

unblocked 

backspace 

one 192W 

block 

Used by J.TINIT to 
initialize terminals 

Backspace 

File 

(M.BACK) 

9 

Spec error 

Backspace 
file to 
previous 
EOF 

Spec error 

Reset request to 
send 

command 

Upspace 

(M.UPSP) 

A 

Upspace 

Multivolume 
only. If BOT, 
writes volume 
record. If 
EOT, performs 
ERASE, writes 
EOF, and 
issues MOUNT 
message. 

1 

Spec error 
on F-class 
disks. For 
floppy only: 
format 
diskette. 

New diskettes 
must be 
formatted 
prior to 
normal usage. 

Set request to send 
command 

Erase or 

Punch 

Trailer 

Not user 

IOCS/handler 

provides call 

automatically 

B 

NOP 

Multivolume 
only. Same 
as upspace 
above. 

Erases 4" of 
tape before 
writing 

NOP 

Set/reset break 
(depends on flags 
in FCB) 


Continued on next page 
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File Control Block (FCB), 16 Word 


Table L-2 

Device Functions (Standard Devices) (Continued) 


IOCS Line Disk 

Op Printer Mag Tape (DM/DF/ Handler=F8XIO 

Operation Code (LP) (M9/MT) DC/Floppy) (8-Line) 

Eject/ 

Punch 

Leader 

(M.EJECT) 

C 

Eject to 
top of 
form 

Write 
dummy 
record 
with eject 
control 
character 
as first 
character 

NOP 

Define special 
character 

Close 

(M.CLSE) 

D 

IOCS 

closes 

IOCS 

closes 

IOCS 

closes 

NOP 

Reserve 

FHD 

Port 

E 

Spec error 

Spec error 

Reserve 

port-4MB 

disk only. 

Else, spec 

error 

Reserve 

Dual 

Ported 

Disk 

Set single-channel 
operation (default) 
command 

Release 

FHD 

Port 

F 

Spec error 

Spec error 

1 

Release 

port-4MB 

disk only. 

Else, spec 

error 

Reserve 

Dual 

Ported 

Disk 

Set dual-channel 
operation 
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File Control Block (FCB), 16 Word 


Table L-3 

Device Functions (Terminals, Handler Action Only) 


Operation 

IOCS 

Op 

Code 

Handler = H.ASMP 
(ALIM) 

Open 

M.FILE 

0 

NOP* 

Rewind 

M.RWND 

1 

NOP* 

Read record 
M.READ 

2 

Read to data buffer 

Write record 
M.WRIT 

3 

Write record to terminal 

Write EOF 
M.WEOF 

4 

NOP* 

Execute channel 

5 

Execute channel 

Advance record 
M.FWRD 

6 

Connect communications channel 

Advance file 
M.FWRD 

7 

Disconnect communications channel 

Backspace record 
M.BACK 

8 

Initialize device and set time-out value 

Backspace 
file M.BACK 

9 

Clear break status flag word 

Upspace 

M.UPSP 

A 

Spec error** 

Erase/punch 

trailer 

B 

Transmit break 

Eject/punch 

leader 

M.EJECT 

C 

Spec error** 

Close 

M.CLSE 

D 

NOP* 

Reserve FHD 
port 

E 

Spec error** 

Release FHD 
port 

F 

Spec error** 

* NOP = No operation performed 
** Spec Error = Illegal operation code 
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File Control Block (FCB), 16 Word 


Table L-4 

Standard Carriage Control Characters and Interpretation 


Control 

Character 

Hexa- 

decimal 

Value 

Result on 
a Terminal 

Result on Directly 
Allocated Printer 
(Serial or parallel) 

SLO 

Blank 

20 

One linefeed, 
one carriage 
return before 
write 

Single space 
before print 

Single space 
before print 

0 

30 

Two linefeeds, 
one carriage 
return before 
write 

Double space 
before print 

Double space 
before 

1 

31 

Five linefeeds, 
one carriage 
return before 
write 

Page eject (slew) 
before print 

Page eject (slew) 
before print 

+ 

2B 

No linefeed, 
no carriage 
return before 
write (line 
append) 

No space before 
print (overprint) 

No space before 
print (overprint) 


2D 

Five linefeeds, 
one carriage 
return before 
write 

Single space 
before print 

Page eject, save 
and print 
up to three user 
supplied title lines. 
See Note 1. 

< 

3C 

One linefeed, 
one carriage 
return before 
write 

Single space 
before print 

Set inhibit spooler 
title line in this file. 

> 

3E 

One linefeed, 
one carriage 
return before 
write 

Single space 
before print 

Set enable spooler 
title line in this file. 


3D 

One linefeed, 
one carriage 
return before 
write 

Single space 
before print 

Page eject and clear 
up to three user- 
supplied title lines 
in this file. 


Notes: 

1. User-supplied title lines have the same effect as this character. Supplying a 
fourth title line clears the first three, but only one page is ejected. User-supplied 
titles are retained by the spooler and are repeated at the top of each page until 
cleared or the spool file ends. 


MPX-32 Reference 


L-31 




File Control Block, Compatible Mode 8 word (FCB) 


L.6 File Control Block, Compatible Mode 8 word (FCB) 


O. 


Word 0 
0 

1 
2 


7 8 


12 13 


31 



Logical file code (FCB.LFC) 

Transfer control word (FCB.TCW) 

General control 
flags 

(FCB.GCFG) 

Special flags 
(FCB.SCFG) 

Random access address 
(FCB.CBRA) 

; Stabs «.*> <PC8.^LG» 




MMlllllIMlllllA) | 


Wait I/O error return address (FCB.ERRT) 

HpiiM 

WT add** ffCMATA) : jj| 


Shaded areas are set by the system. 


A.L8W.FCB 


WordO 

Bit 0 Reserved 

Bits 1-7 Operation code (FCB.OPCD) — type of function requested of 

the device handler. This field is set by IOCS as a function of the 
requested service. 

Bits 8-31 Logical file code (FCB.LFC) — any combination of three ASCII 
characters is allowed. 




Word 1 (FCB.TCW) 

This word supplies a transfer control word (TCW) that describes a data buffer 
and transfer quantity. If no TCW definition is supplied, the transfer buffer 
defaults to location zero of the task’s logical address space and is 4096 words 
long. 

Bits 0-11 Quantity — 12 bit field specifying the number of data 
items to be transferred. This quantity must include the 
carriage control character, if applicable. The transfer quantity 
is in units determined by the address in bits 12 to 31. 
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File Control Block, Compatible Mode 8 word (FCB) 


Bits 12-31 Format code and buffer address — bits 12, 30 and 31 

specify byte, halfword, or word quantities for data transfers. 
They are interpreted as follows: 


Type of 
Transfer 

F 

(12) 

c 

(30,31) 

Address 

Byte 

1 

XX 

13-31 

Halfword 

0 

xl 

13-30 

Word 

0 

00 

13-29 


Word 2 

Bits 0-7 General control flags (FCB.GCFG) — these eight bits enable the user to 
specify the manner in which an operation is to be performed by IOCS. 
The interpretation of these bits is shown below: 
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File Control Block, Compatible Mode 8 word (FCB) 


Bit 

0 

1 


2 

3 

4 

5 

6 
7 

Bits 8-12 
Bits 13-31 


Meaning 

if Set Definition 

NWT IOCS returns to the user immediately after the 

I/O operation is queued. If reset, IOCS exits to the 
calling program only when the requested operation 
has been completed. 

NER error processing is not performed by either the device 

handler or IOCS. An error return address is ignored 
and a normal return is taken to the caller, however, 
the device status is posted in the FCB unless bit 
3 is set. If reset, normal error recovery is 
attempted. Normal error processing for disk and 
magnetic tape is automatic error retry. Error 
processing for unit record devices except the 
system console is accomplished by IOCS typing 
the message INOP to the console, which allows 
the operator to retry or abort the I/O operation. 

If the operator aborts the I/O operation, or if 
automatic error retry for disk or magnetic tape is 
unsuccessful, an error status message is typed 
to the console and the error return address is 
taken if provided. Otherwise, the task is aborted. 

DFT data formatting is inhibited. Otherwise, data 

formatting is performed by the appropriate device 
handler. See Table L-5 for more explanation. 

NST device handlers perform no status checking and no 

status information is returned. All I/O appears 
to complete without error. Otherwise, status 
checking is performed and status information 
is returned as necessary. 

RAN file accessing occurs in the random mode. 

Otherwise, sequential accessing is performed. 

reserved (M.FILE) 

EXP must be 0 for 8 word FCB. 

IEC this bit is reserved for internal IOCS use. 


Special Control Specification (FCB.SCFG). — This field 
contains device control specifications unique to certain devices. 
Interpretation and processing of these specifications are performed 
by the device handlers. A bit setting is meaningful only when a 
particular type of device is assigned as indicated in Table L-2. 

Random access address (FCB.CBRA) — This field contains 
a block number (zero origin) relative to the beginning of the disk 
file, and specifies the base address for read or write operations. 
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Table L-5 

Special Control Flags (8 Word FCB) 


Device 

Bit 2=0 

Bit 2=1 

Bit 8=0 

Bit 8=1 

Bit 9=0 

Bit 9=1 

Line 

Printer 

(LP) 

Interpret first 
character as 
carriage 
control 

Interpret first 
character as 
data 

See bit 8 

Form 

control 

No form 
control 



Discs, 

(DM,DF, 

FL) 

Report EOF if 
X’OFEOFEOF ’ 
encountered 
in word 0 of 
1st block 
during read 
of unblocked 
file 

X’OFEOFEOF * 
in word 0 
not 

recognized 
as EOF 





8 -Line 

Asynchronous 

Communications 

Multiplexer 

(TY) 

M.READ 

M.READ 

M.READ 

M.READ 

M.READ 

M.READ 

Perform 

special 

character 

formatting 

No special 

character 

formatting 

ASCH control 
passed as 
data 

ASCH control 

character 

detect 

Echo by 
controller 

No echo by 
controller 


M.WRIT 

M.WRIT 

SVC 1,X’3E’ 

SVC 1,X’3E’ 

M.WRIT 

M.WRIT 


Interpret first 
character as 
carriage 
control 

Interpret first 
character as 
data 

Stop 

transmitting 

break 

Start 

transmitting 

break 

Normal 

write 

Initialize 
device (load 
UART 
parameters) 


Device 

Bit 10=0 

Bit 10=1 

Bit 11=0 

Bit 11=1 

Bit 12=0 

Bit 12=1 

Line Printer (LP) 

Reserved 

Reserved 

Reserved 

Reserved 

Reserved 

Reserved 

Discs, 

(DM,DF, 

FL) 







8-Line 

Asynchronous 

Communications 

Multiplexer 

(TY) 

M.READ 

M.READ 

M.READ 

M.READ 

M.READ 

M.READ 

(If bit 2=0) 
convert lower 
case 

character 
to upper case 

Inhibit 

conversion 

No special 

character 

detect 

Special 

character 

detect 

Do not purge 
type ahead 
buffer 

Purge type 
ahead buffer 


M.WRIT 

M.WRIT 

M.WRIT 

M.WRIT 

M.WRIT 

M.WRIT 




Normal write 

Write with 
input sub- 
channel 
monitoring 
plus software 
flow control 




Continued on next page 
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Table L-5 

Special Control Flags (8 Word FCB) ( Continued ) 


Device 

(Bit 2=0) 

(Bit 2=1) 

Bit 8 

Bit 9 


Bit 10 

Bit 11 

Bit 12 

ALIM 

Read: 

Bit 2 

Bit 8 

Bit 9 

Read 

On Read: 



(Asynch- 

receive 








ronous 

data 

0 

1 

0 

=Blind mode reset 

1= Inhibit 



Line 

(bytes) 

0 

0 

1 

=Echo on read 

conversion 



Interface 

defined 

1 

N/A 

N/A 

=Receive data 

of lower 



Module) 

for 

0 

0 

0 

=Receive data 

case 



Terminals 

transfer 





characters 



(TY) 

count 





to upper 








Write 

case 




Write: 

0 

N/A 

0 

=Formatted write 

0= Convert 




formatted 

0 

N/A 

1 

initialize device 






1 

N/A 

N/A 

Unformatted write 
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Word 3 

Bits 0-31 Status word (FCB.SFLG) — 32 indicator bits are set by IOCS to 
indicate the status, error, and abnormal conditions detected 
during the current or previous operation. The assignment of 
these bits is shown as follows: 


Meaning 


Bits 

if Set 

Definition 

0 

OP 

operation in progress. Request has 
been queued. (Note: Reset after post I/O 
processing complete.) 

1 

ERR 

error condition found 

2 

BB 

invalid blocking buffer control pointers 
have been encountered during file blocking 
or unblocking 

3 

PRO 

write protect violation 

4 

INOP 

device inoperable 

5 

BOM 

beginning-of-medium (BOM) (load point) 
or illegal volume number (multivolume 
magnetic tape) 

6 

EOF 

end-of-file 

7 

EOM 

end-of-medium (end of tape, end of 
disk file) 

8-9 


reserved 

10 

TIME 

last command exceeded time-out value 
and was terminated 

11-15 


reserved 

16 

ECHO 

echo 

17 

INT 

post program-controlled interrupt 

18 

LEN 

incorrect length 

19 

PROG 

channel program check 

20 

DATA 

channel data check 

21 

CTRL 

channel control check 

22 

INTF 

interface check 

23 

CHAI 

chaining check 

24 

BUSY 

busy 

25 

ST 

status modified 

26 

CTR 

controller end 

27 

ATTN 

attention 

28 

CHA 

channel end 

29 

DEV 

device end 

30 

CHK 

unit check 

31 

EXC 

unit exception 
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Word 4 

Bits 0-31 

Word 5 

Bits 0-7 
Bits 8-31 

Word 6 

Bits 0-7 


Bits 8-31 


Word 7 
Bits 0-7 

Bits 8-31 


Record length (FCB. RE CL) — this field is set by IOCS to indicate the 
actual number of bytes transferred during read/write operations. 


Reserved 

I/O queue address (FCB.IOQA) — this field is used by IOCS to point 
to the I/O queue for an I/O request initiated from this FCB 


Special status bits (FCB.SPST). The interpretation 
of these bits is shown below: 

Bits Definition 

0 no-wait normal end action not taken 

1 no-wait error end action not taken 

2 kill command, I/O not issued 

3 if set, exceptional condition has occurred in the 
I/O request 

4 if set, software read flow control required 

5-7 reserved 


Wait I/O error return address (FCB.ERRT) — this field is set by the 
user and contains the address to which control is to be transferred 
in the case of an unrecoverable error when control bits 1 and 3 
of word 2 are reset. If this field is not initialized and an 
unrecoverable error is detected under the above conditions, the 
user is aborted. 


Index to FPT (FCB.FPTI) — this field indexes into the appropriate 
entry in the file pointer table (FPT) 

FAT address (FCB.FATA) — this field points to the file assignment 
table (FAT) entry associated with all I/O performed for this 
FCB. This field is supplied by IOCS. 
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L.7 File Control Block (FCB), High Speed Data 

The following section details the 16 words that make up the FCB for the HSD. 


Word 0 


15 16 


23 24 


0 | Opcode Logical file code (FCB.LFC) 


2 General control Special flags 

flags (FCB.SCFG) 

(FCB.GCFG) I 

3 Status f tags iFCB.SFI G) 


MB 


UDDCMD oflOCD 
if bit 1 1 of word 2 
is set 




6 : Special Statius Wait I/O error return address (FCB.ERRT) 

MiBMmI HU 

8 lliiiii p lll Data address (FCB.ERWA) 

9 Transfer quantity (bytes) (FCB.EQTY) 

10 Device command for non-EXCPM (FCB.ERAA) 

1 1 i Reserved 

12 


13 .’Reserved 

14 p|||ippy||;;; 

15 ; Reserved 


No-wait I/O normal end-action service address (FCB.NWOK) 
No- wait I/O error end-action service address (FCB.NWER) 


Shaded areas are set by the system. 


WordO 


T2FCB 


Reserved 


Bits 1-7 Contain the operation code, set by IOCS that specifies the type of 
function requested of H.HSDG. 

Bits 8-31 Contain the logical file code associated with the device for the I/O 
operation. 


Word 1 


This word is reserved and should be set to zero. 
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Word 2 

Bits 0-7 Contain control flags that enable the user to specify how an operation 
is to be performed by IOCS. Following is the meaning of these bits 
when they are set: 

Bit Meaning When Set 

0 IOCS returns to the user immediately after the 
I/O operation is queued (no wait I/O). If reset, 

IOCS exits to the calling program only when the 
HSD completes the requested operation (wait I/O). 

1 H.HSDG and IOCS do not perform error processing. 

IOCS ignores the error return address and takes 

a normal return to the caller. H.HSDG posts 
device status in the FCB (unless bit 3 is set). 

If reset, H.HSDG and IOCS perform error processing. 

2 specifies physical execute channel program. If 
reset, specifies logical channel program or non- 
execute channel program I/O request 

3 IOCS performs no status checking and does not 
return status information. All I/O appears to complete 
without error. If reset, IOCS performs status checking 
and returns status information. 

4, 5 Reserved, should be zero. 

6 specifies 16 word FCB. Must be set to 1. 

7 reserved for internal IOCS use. 
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Bits 8-23 contain the following special flags: 

Bit Meaning When Set 

8 specifies request device status after a transfer. 

H.HSDG adds an IOCB to the IOCL to retrieve 
device-specific status after the data transfer completes. 

9 specifies send device command prior to data transfer. 

H.HSDG prefixes the transfer with an IOCB that sends 
a device command word to the device. The value sent 
is the 32-bits contained in word 10 of the FCB. 

10 specifies disable time out for this request. This 

bit indicates the operation will take an indeterminable 
period of time. In most cases this applies only to 
read operations. 

1 1 specifies set UDDCMD from the least significant 
byte of word 2. This bit indicates that the UDDCMD 
byte in the data transfer IOCB must be set to the least 
significant byte of FCB word 2. This allows the user 
to pass additional control information to the device 
without modifying the device driver. 

12 specifies disable asynchronous status notification 
during no-wait I/O. 

13 specifies the execute channel program request INIT. 

By setting this bit, all preliminary I/O data structures 

are set up based on the I/O command list address provided in 
word 8 of the FCB. When set, this bit prepares for future 
cyclic I/O requests but does not issue any I/O. 

14 specifies the execute channel program request GO. This 
bit issues an SIO for the most recently processed INIT 
execute channel program request (see bit 13). 

15-23 reserved 

Note: For further information on the HSD FCB please see the H.HSDG 

section in the MPX-32 Technical Manual Volume II. 

Bits 24-31 if bit 11 is set, these bits define the UDDCMD field of the generated 
IOCB, overriding the default value from a handler table. This field 
applies only to FCB format. 
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Word 3 

IOCS uses this word to indicate status, error, and abnormal conditions detected 
during the current or previous operation. Following is the meaning of the bits 
when they are set: 


Bit 

Meaning When Set 

0 

operation in progress. Request has been queued. 
This bit is reset after post I/O processing completes. 

1 

error condition found 

2,3 

not applicable, should never be returned 

4 

device inoperable, HSD not present or offline 

5-15 

not applicable, should never be returned 

16 

a time-out occurred and a CD terminate was 
issued. 

17, 18 

not applicable, should never be returned 

19 

there was data remaining in the HSD fifo when 
the transfer count equaled zero. 

20 

a parity error occurred during the current data 
transfer. 

21 

a non-present memory error occurred during 
the current data transfer. 

22 

program violation. An invalid operation code 
was detected. 

23 

device inoperative 

24 

HSD data buffer overflow. Some data from the 
device was lost. 

25 

external termination 

26 

IOCB address error 

27 

error on TI address fetch 

28 

device EOB 

29 

Non-device access errors precluded request queuing. 
For a list of the errors, see word 12. 

30, 31 

non-execute channel program type of IOCB in 
error as follows: 


O 


Value 

Meaning 

00 

data transfer 

01 

device status 

10 

command transfer 


Word 4 

This word specifies the record length. For non-execute channel program I/O, 
IOCS sets this word to indicate the number of bytes transferred during read or 
write operations. 
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( 


Word 5 

Bits 0-7 reserved 

Bits 8-31 specify the IOQ address. IOCS sets this field to point to the IOQ 
entry initiated from this FCB. 

Word 6 

Bits 0-7 specify special status as follows: 

Bit Meaning When Set 

0 no-wait normal end action not taken 

1 no-wait error end action not taken 

2 kill command, I/O not issued 

3 an exception condition has occurred in the I/O request 

4 not used 

5-7 reserved 

Bits 8-31 contain the wait I/O error return address. The user sets this field to 
the address where control is to be transferred for unrecoverable errors 
when bits 0, 1, and 3 of word 2 are reset. If this field is not 
initialized and an unrecoverable error is detected under the above 
conditions, the user task is aborted. 

Word 7 

Bits 0-7 set by the I/O control system (IOCS), contains an index to the file 
pointer table (FPT) entry for this I/O operation. 

Bits 8-15 supplied by the IOCS, points to the file assignment table (FAT) entry 
associated with this FCB. 
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Word 8 

Bits 0-7 reserved 

Bits 8-31 these bits are used as the data address, a logical IOCL address, or a 
physical IOCL address as follows: 

Data address - This is the starting address of the data area for FCB 
format I/O operations. This address must be a word address. 

Logical IOCL address - This is a logical, doubleword address that 
points to a user-supplied IOCL for SIO format I/O operations. For 
more information about SIO format, refer to Reference Manual 
Volume I, Chapter 3. The execute channel program entry point 
(H.IOCS,10) must be used and bit 2 of word 2 of the FCB is reset. 
All addresses within the IOCL are assumed to be logical and map 
block boundary crossings need not be resolved. 

Physical IOCL address - This is a physical, doubleword address that 
points to a user-supplied IOCL for SIO format I/O operations. The 
execute channel program entry point (H.IOCS.IO) must be used and 
bit 2 of word 2 of the FCB is set. All addresses within the IOCL are 
assumed to be physical and all map block boundary crossings are 
assumed to be resolved. 

Word 9 

This word specifies the number of bytes of data to be transferred. 

Word 10 

For nonexecute channel program format, this word defines a device command. 
Word 11 

Reserved — should be set to zero. 

Word 12 

This word contains status sent from the user’s device or if bit 29 of word 3 is set, 
this word defines the opcode processor (EP5) detected errors as follows: 

Value Explanation 

1 request made with non-expanded FCB 

2 FCB format transfer count was zero 

3 FCB format, byte transfer count was not 
a multiple of 4 bytes 

4 SIO format with a physical IOCL request 
by an unprivileged caller 

5 SIO format with a physical IOCL request 
by a nonresident caller 

6 first IOCB in caller’s IOCL is a transfer in channel 

7 caller’s IOCL not on a doubleword boundary 

8 SIO format IOCL contains an IOCB with a 
zero transfer count 

9 infinite transfer in channel loop 

10 consecutive SOBNZ’s in IOCL 


4 

V/ 


r 
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1 1 SOBNZ target is not in the IOCL 

12 the transfer address is not on a word 
boundary 

13 unprivileged caller’s input buffer includes 
protected locations 

14 unprivileged caller’s input buffer is unmapped 
either in MPX-32 or below DSECT 

15 cyclic I/O request was made for which no cyclic 
IOQ is current 

16 cyclic I/O request was made and permanent IOQ 
support was not sysgened into the system 


Word 13 

Bits 0-7 reserved 

Bits 8-31 contain the address of the user-supplied routine to branch to for no- 
wait I/O normal completion. This routine must be terminated by 
calling H.IOCS.34 (no-wait I/O end action return). If word 2 bit 12 
is reset, this address plus one word is the location where control is 
transferred on asynchronous status notification. 

Word 14 

Bits 0-7 reserved 

Bits 8-31 contain the address of the user-supplied routine to branch to for no- 
wait I/O error completion. This routine must be terminated by 
calling H.IOCS,34 (no-wait I/O end action return). 

Word 15 

Reserved — should be set to zero. 
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L.8 File Pointer Table (FPT) 

The file pointer table (FPT) provides the linkage between the file control block (FCB) 
and the file assignment table (FAT). It also allows for multiple logical file code 
assignments to be made equivalent to the same FAT. The linkage to the FAT is 
performed at assignment. The linkage to the FCB is performed at open and is re- 
established if necessary for every operation at opcode processing time. The FPT 
resides in the task’s service area. 

FPT entries one to six are reserved for the system as follows: 

Entry 1 - System LFC *s* 

Entry 2 - Load module LFC *LM 

Entry 3 - H.VOMM resource descriptor LFC (1) 

Entiy 4 - H.VOMM directory LFC (2) 

Entry 5 - H.VOMM DMAP/SMAP LFC (3) 

Entry 6 - H.VOMM modify resource descriptor LFC X’FFFEE’ 

Each FPT entry has the following format: 


WordO 

1 


2 


Notes: 


0 7 8 15 16 23 24 31 


Reserved 

Logical file code (FPT.LFC) 

Flags (FPT.FLGS). 
See Note 1. 

FCB address (FPT.FCBA) 

Reserved 

FAT address (FPT.FATA) 


:0 "\ 


'V 


1. Bits in FPT.FLGS are assigned as follows: 

Bit Meaning if Set 

0 reserved 

1 multiple FPT entries exist that point to the same FAT 

(i.e., SASSIGN4 or $ASSIGN Ifc TO LFC = Ifc statements) 

2 FPT busy flag 

3 FPT open 

4 this FPT entry is not in use 

5 pseudo-SYC assignment (used by TSM) 

6 pseudo-FPT for unassigned tempory file 

7 reserved 
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L.9 Parameter Task Activation Block 

The following is the structure of the expanded parameter task activation block: 

Byte Word 
0 0 

4 1 

8 2-3 

10 4-5 

18 6-7 

20 8-9 

28 10 

2C 11 

30 12 

34 13 

38 14 

3C 15 

40 16-19 

50 -nn 20-nn 


_0 

PTA.FLAG 


7 8 


15 16 


23 24 


31 


PTA.NRRS 


PTA.ALLO 


PTA.MEMS 


PTA.NBUF 


PTA.NFIL 


PTA.PRIO 


PTA.SEGS 


PTA.NAME 


PTA.PSN 


PTA.ON 


PTA.PROJ 


PTA.VAT 


PTA.FLG2 


PTA.EXTD 


PTA.PGOW 


PTA.TSW 


PTA.RPTR 


PTA.PG02 


PTA.FSIZ 


PTA.RSIZ 


Reserved (zero) 
RRS List 


Byte 

(Hex) Symbol Description 


0 PTA.FLAG contains the following: 

Bit Contents 

0 reserved 

1 job oriented (PTA.JOB) 

2 terminal task (PTA.TERM) 

3 batch task (PTA.BTCH) 

4 debug overlay required (PTA.DOLY) 

5 resident (PTA.RESD) 

6 directive file active (PTA.DFIL) 

7 SLO assigned to SYC (PTA.SLO) 

For unprivileged callers, bits 0-3 are not 
applicable. These characteristics are inherited 
from the parent task. 

1 PTA.NRRS number of resource requirements or zero if same as 

summary entries in the load module or executable image 
preamble 
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Byte 

(Hex) 

2 

3 


4 

5 

6 


7 

8 


10 


18 


20 


28 


Symbol 

PTA.ALLO 

PTA.MEMS 


PTA.NBUF 

PTA.NFIL 

PTA.PRIO 

PTA.SEGS 

PTA.NAME 

PTA.PSN 


PTA.ON 

PTA.PROJ 

PTA.VAT 


Description 




memory requirement: number of 5 12- word pages 
exclusive of TSA, or zero if same as the preamble 

memory class (ASCII E, H or S) or zero if memory 
class is to be taken from the preamble. If the memory 
class is to be taken from the preamble, the caller has 
the option of specifying the task’s logical address space 
in this field as follows: 

Bits Contents 

0-3 hexadecimal value 0 through F representing 

the task’s logical address space in megabytes 
where zero is 1MB and F is 16MB 

4-7 zero 

the number of blocking buffers required or 
zero if same as the preamble 

the number of FAT/FPT pairs to be reserved or 
zero if same as the preamble 

the priority level at which the task is to be activated 
or zero for the cataloged load module priority. See 
the Parameter Send Block section in Chapter 2 
of the MPX-32 Reference Manual Volume I, 
for more details. 

the segment definition count or reserved (zero) 

contains the load module or executable image name, 
left justified and blank filled, or word 2 is zero and 
word 3 contains a pathname vector or RID vector 

contains the 1- to 8-character ASCII pseudonym, left 
justified and blank filled, to be associated with the task 
or zero if no pseudonym is desired. For unprivileged 
callers, this attribute is inherited from the parent task 
if zero is supplied or the parent is in a terminal or 
batch job environment. 

contains the 1- to 8-character ASCII owner name, 
left-justified and blank-filled, to be associated with the 
task or zero if the task to default to the current owner name. 
Valid only when task has system administrator attribute. 

contains the 1- to 8-character ASCII project name, 
left-justified and blank-filled, to be associated with files 
referenced by this task, or zero if same as LMIT 

the number of volume assignment table (VAT) entries 
to reserve for dynamic mount requests or zero if same 
as the preamble 
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Byte 

(Hex) 

29 


2A 


2C 

30 

34 


38 

3C 

3E 

40 


Symbol 

PTA.FLG2 


PTA.EXTD 


PTA.PGOW 

PTA.TSW 

PTA.RPTR 


PTA.PG02 

PTA.FSIZ 

PTA.RSIZ 

Reserved 


Description 


contains the following flags: 

Bit Meaning if Set 

0 debug activating task (PTA.DBUG) 

1 Command Line Recall and Edit is in 
effect for the task (PTA.CLRE) 

2 NOTSA option (PTA.NTSA) 

3 TSA option (PTA.TSA) 

4 expanded PTASK block flag (must 

be set to use options 33-64) (PTA.EBLK) 

5 reserved (zero) 

6 enables NOMAPOUT option (PTA.NMAP) 

7 enables MAPOUT option (PTA.MAP) 

contains the following values: 

Bit Meaning if Set 

- 1 maxaddr of extended MPX-32 and TSA 

-2 minaddr of extended MPX-32 and TSA 

0 invalid with PTA.TSA or PTA.NTSA option 

n a positive number representing a 

map block of MPX-32 and TSA 

contains the initial value of the task option word or zero 
contains the initial value of the task status word or zero 

contains a pointer to the resource requirement summary 
list or, if an expanded PTASK block is not used, the RRS 
list begins here (see resource requirement summary list 
description below) 

contains the initial value of the second task option word 

contains the length of the fixed portion of 
the PTASK block in bytes 

contains the number of bytes of the resource 
requirement summary 
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f \ 


50 resource requirement summary list. Each entry contains 

a variable length RRS. The RRS list has up to 384 words. 
Each entry must be doubleword bounded. Each entry is 
compared with the RRS entries in the LMIT. If the 
logical file code currently exists, the specified 
LFC assignment will override the cataloged assignment, 
otherwise the special assignment will be treated 
as an additional requirement and merged into the 
list. If MPX-32 Revision 1.x format of the 
RRS is specified, it is converted to the format acceptable 
for assignment processing by the Resource Management 
Module (H.REMM). See MPX-32 Revision 1 jc 
T echnical Manual for format of the RRS. 


Byte 

(Hex) Symbol Description 


L.10 TSM Procedure Call Block (PCB) 

The PCB contains the information necessary for the service to complete a procedure 
call. The format of the PCB is as follows: 


0 7 8 15 16 23 24 31 


WordO 


Send buffer address (PCB.SBA) 

1 

Send quantity (PCB.SQUA) 

2 


Return buffer address (PCB.RBA) 

3 

Actual return length (PCB.ACRP) Return buffer length (PCB.RPBL) 


Send bulfer address 
Send quantity 
Return buffer address 

Actual return length 
Return buffer length 


is the address of a character string that represents a valid 
TSM procedure call directive 

contains the length in bytes of the TSM procedure call 
directive 

is the address of a buffer to contain either valid return 
information or an error message if CC1 is set and R7 
contains a value of 1 

is the number of bytes returned from the procedure call 
is the size in bytes of the supplied return buffer 


L.11 Pathname Blocks (PNB) 

The pathname block (PNB) is an alternative form of a pathname that can be used 
interchangeably with pathnames. Because of its structure, it can be parsed faster than 
a pathname. The PNB is a doubleword bounded, variable length ASCII character 
string which H.VOMM can distinguish from a pathname since the PNB always starts 
with an exclamation point. 
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H.VOMM provides a service to convert a pathname to a PNB. The examples which 
follow illustrate common pathnames and their corresponding PNB. 

Example 1 


0VOL1 (DIRl) FILEl Word 0 

! V 0 L 

1 

blank 

2 

V 0 L 1 

3 

blank 

4 

blank 

5 

blank 

6 

! D I R 

7 

ROOT 

8 

DIRl 

9 

blank 

10 

blank 

11 

blank 

12 

IRES 

13 

blank 

14 

FILE 

15 

1 Y> Y> J6 

16 

blank 

17 

blank 


Example 2 


FILEl 


WordO 

! V 0 L 

1 

WORK 

2 

! D I R 

3 

WORK 

4 

IRES 

5 

blank 

6 

FILE 

7 

1 16 JS 16 

8 

blank 

9 

blank 
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Example 3 

(DIRECTORY) MYFILE 


Example 4 

0 SYSTEM (SYSTEM) LOADMOD 


/f 




WordO 

! V 0 L 

1 

WORK 

2 

! D I R 

3 

ROOT 

4 

DIRE 

5 

C T 0 R 

6 

Y # 16 # 

7 

blank 

8 

IRES 

9 

blank 

10 

M Y F I 

11 

L E # # 

12 

blank 

13 

blank 


WordO 

! V 0 L 

1 

S Y S T 

2 

! D I R 

3 

S Y S T 

4 

IRES 

5 

blank 

6 

LOAD 

7 

MOD# 

8 

blank 

9 

blank 
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L.12 Post Program-Controlled Interrupt Notification Packet 
(PPCI) 

If a task sets up a PPCI end-action receiver to check status during execution of its 
channel program, the status is returned in a notification packet. The address of the 
notification packet is contained in register three upon entering the task’s PPCI end- 
action receiver. The notification packet is described below. 


0 7 8 15 16 23 24 31 


WordO 

String forward address (NOT.SFA) 

1 

String backward address (NOT.SBA) 

2 

Link priority 

NOT.TYPE 

Reserved 


(NOT.PRI) 

See Note 1. 


3 

FCB address (NOT.CODE) 

4 

PSD 1 of task’s PPCI receiver (NOT.PSD1) 

5 

PSD 2 of task’s PPCI receiver (NOT.PSD2) 

6 

Number of PPCIs received 

Number of status 


since last buffer clear 

doublewords in status buffer 


(NOT.STAR) 


(NOT.STAS) 

7 

Address of PPCI status buffer (NOT.STAA) 

8 

Address of buffer storing next status doubleword (NOT.STPT) 

9 

Reserved 

10-/J 

PPCI status buffer 


Notes: 

1. NOT.TYPE - Set to 1 for asynchronous notification. 

2. Words 0-9 are updated by the operating system and must not be changed by the 
user. 
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L.13 Parameter Receive Block (PRB) 

The parameter receive block (PRB) is used to control the storage of passed parameters 
into the receiver buffer of the destination task. The same format PRB is used for 
message and run requests. The address of the PRB must be presented when the 
M.GMSGP or M.GRUNP services are invoked by the receiving task. 


0 7 8 15 16 23 24 31 


WordO 

Status (PRB.ST) 

Parameter receiver buffer address (PRB.RBA) 

1 

Receiver buffer length (PRB.RBL) 

Number of bytes actually received 
(PRB.ARQ) 

2 

Owner name of sending task, word one (PRB.OWN) 

3 

Owner name of sending task, word two 

4 

Task number of sending task (PRB.TSKN) 


Notes: 

1. Status (PRS.ST) contains the status-value encoded status byte: 

Code Definition 

0 normal status 

1 invalid PRB address (PRB.ER01) 

2 invalid receiver buffer address or size detected during 
parameter validation (PRB.RBAE) 

3 no active send request (PRB.NSRE) 

4 receiver buffer length exceeded (PRB.RBLE) 

2. Parameter receiver buffer address (PRB.RBA) contains the word address of the 
buffer where the sent parameters are stored. 

3. Receiver buffer length (PRB.RBL) contains the length of the receiver buffer (0 to 
768 bytes). 

4. Number of bytes received (PRB.ARQ) is set by the operating system and is 
clamped to a maximum equal to the receiver buffer length. 

5. Owner name of sending task (PRB.OWN) is a doubleword that is set by the 
operating system to contain the owner name of the task that issued the parameter 
send request. 

6. Task number of sending task (PRB.TSKN) is set by the operating system to 
contain the task activation sequence number of the task that issued die parameter 
send request. 
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L.14 Parameter Send Block (PSB) 

The parameter send block (PSB) describes a send request issued from one task to 
another. The same PSB format is used for both message and run requests. The 
address of the PSB (word bounded) must be specified when invoking the M.SMSGR 
or M.SRUNR services, but is optional when invoking the M.PTSK service. 

When a load module name is supplied in words 0 and 1 of the PSB, the operating 
system searches the system directory only. For activations in directories other than 
the system directory, a pathname or RID vector must be supplied. 

When activating a task with the M.SRUNR or M.PTSK service, the value specified in 
byte 0 of PSB word 2 (PSB.PRI) is used to determine the task’s execution priority. 
TTiis value overrides the cataloged priorities of the sending and receiving tasks and the 
priority specified in the PTASK block. However, priority clamping is used to prevent 
time-distribution tasks from using this value to execute at a real-time priority, and 
real-time tasks from executing at a time-distribution priority. Values that can be 
specified in PSB.PRI are 1-64 (to be the task priority), zero (to use the base priority of 
the sending task), and X’FF’ (to ignore the PSB priority field). 

A PSB can be specified as a parameter for the M.PTSK service, along with the 
required task activation (PTASK) block The PTASK block also contains a priority 
specification field. The PSB priority value always overrides the PTASK block priority 
value. 


0 7 8 15 16 23 24 31 


WordO 

Load module or executable image name (PSB.LMN) or zero if activation 
(or task number (PSB.TSKN) if message or run request to multicopied task) 

1 

Load module or executable image name, pathname vector, or RID vector 
if activation (or zero if message or run request to multicopied task) 

2 

Priority 

(PSB.PRI) 

Reserved 

Number of bytes to be sent (PSB.SQUA) 

3 

Reserved 

Send buffer address (PSB.SBA) 

4 

Return parameter buffer length 
in bytes (PSB.RPBL) 

Number of bytes actually 
returned (PSB.ACRP) 

5 

Reserved 

Return parameter buffer address (PSB.RBA) 

6 

Reserved 

No-wait request end action address (PSB.EAA) 

7 

Completion 
status (PSB.CST) 

Processing 
start status 
(PSB.IST) 

User status 
(PSB.UST) 

Options 

(PSB.OPT) 
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Word 0 J 

Bits 0-31 Load module or executable image name — contains characters 1 
through 4 of the name of the load module or executable image to 
receive the run request or 

Task number — contains the task number of the task to receive 
the message or the task number of the multicopied load module 
or executable image to receive the run request. 

Word 1 

Bits 0-31 Load module or executable image name — contains characters 5 
through 8 of the name of the load module or executable image to 
receive the run request, or zero if the message or run request is 
sent to multicopied load module or executable image. 

Word 2 

Bits 0-7 Contains the priority at which the receiver task is expected to be 
activated. Valid values are 1-64, zero, (for base priority of the 
sending task) and X’FF\ which generates activation priority 
based on a combination of values that can be specified during 
task activation. 

The following tables show how the priority of a receiver task is determined when < 

activated with M.SRUNR or with M.PTSK. 

When Activating with M.SRUNR 


Cataloged 


Priority of 

Send Task Receive task 

Priority 
in PSB 

Activates 
Receive task at 

1-54 

1-54 

0 

Send task cat. priority 

1-54 

55-64 

0 

55 (time-dist. clamp) 

55-64 

1-54 

0 

54 (real-time clamp) 

55-64 

55-64 

0 

Send task cat. priority 

* 

1-54 

1-54 

PSB priority 

★ 

1-54 

55-64 

54 (real-time clamp) 

* 

55-64 

1-54 

55 (time-dist. clamp) 

* 

55-64 

55-64 

PSB priority 

* 

* 

X’FF 

Receive task cat. priority 


* not specified 

( 
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When Activating with M.PTSK 


Cataloged 


Priority of 

Priority in 


Send 

Receive 

PTASK 


Activates 

Task 

task 

block 

PSB 

Receive task at 

1-54 

1-54 

0 

0 

Send task cat. priority 

1-54 

55-64 

0 

0 

55 (time-dist. clamp) 

1-54 

★ 

1-54 

0 

Send task cat. priority 

1-54 

* 

55-64 

0 

55 (time-dist. clamp) 

55-64 

1-54 

0 

0 

54 (real-time clamp) 

55-64 

55-64 

0 

0 

Send task cat. priority 

55-64 

* 

1-54 

0 

54(real-time clamp) 

55-54 

* 

55-64 

0 

Send task cat priority 

* 

1-54 

0 

1-54 

PSB priority 

* 

1-54 

0 

55-64 

54 (real-time clamp) 

* 

55-64 

0 

1-54 

55 (time-dist.clamp) 

* 

55-64 

0 

55-64 

PSB priority 

* 

* 

1-54 

1-54 

PSB priority 

* 

* 

1-54 

55-64 

54 (real-time clamp) 

* 

* 

1-54 

X’FF’ 

PTASK block priority 

* 

* 

55-64 

1-54 

55 (real-time clamp) 

* 

* 

55-64 

55-64 

PSB priority 

* 

3k 

55-64 

X’FF’ 

PTASK block priority 

* 

* 

0 

X’FF’ 

Receive task cat. priority 

* not specified 




Bits 8-15 

reserved 



Bits 16-31 

Number of bytes to be sent — 

specifies the number of bytes to 



be passed (0 to 768) with the message or run request. 

Word 3 





Bits 0-7 

reserved 



Bits 8-31 

Send buffer address — contains the word address of the buffer 



containing the parameters to be sent. 

Word 4 





Bits 0-15 

Return parameter buffer length 

— contains the maximum number 



of bytes (0 to 768) that may be accepted as returned parameters. 

Bits 16-31 

Number of bytes actually returned — set by the send message or 


run request service upon completion of the request. 
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Word5 


Bits 0-7 reserved 

Bits 8-31 Return parameter buffer address — contains the word address of 
the buffer where any returned parameters are stored. 

Word 6 

Bits 0-7 reserved 


Bits 8-31 No-wait request end-action address — contains the address of a 
user routine to be executed at a software interrupt level upon 
completion of the request. 

Word 7 

Bits 0-7 Completion status — contains completion status information 
posted by the operating system as follows: 


Bit Meaning if Set 

0 operation in progress (PSB.OIP) 

1 destination task was aborted before completion of 
processing for this request (PSB.DTA) 

2 destination task was deleted before completion of 
processing for this task (PSB .DTD) 

3 return parameters truncated — attempted return 

exceeds return parameter buffer length (PSB.RPT) 

4 send parameters truncated — attempted send exceeds 
destination task receiver buffer length (PSB.SPT) 

5 user end-action routine not executed because of 

task abort outstanding for this task (can be examined 
in abort receiver to determine incomplete operation) 
(PSB.EANP) 

6-7 reserved 


f' ^ 
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Bits 8-15 Processing start (initial) status — contains initial status 
information posted by the operating system as follows: 

Bit Meaning if Set 

0 normal initial status (PSB. 1ST) 

1 message request task number invalid (PSB.TSKE) 

2 run request load module or executable image name not 
found (PSB.LMNE) 

3 reserved 

4 file associated with run request load module or 
executable image name does not have a valid 

load module or executable image format (PSB.LMFE) 

5 dispatch queue entry (DQE) space is unavailable for 
activation of the load module or executable image 
specified by a run request (PSB.DQEE) 

6 an I/O error was encountered while reading the 
directory to obtain the file definition of the 

load module or executable image specified in a run 
request (PSB.SMIO) 

7 an I/O error was encountered while reading the 

file containing the load module or executable image 
specified in a run request (PSB.LMIO) 

8 memory unavailable 

9 invalid task number for run request to module 
or executable image in RUNW state 

10 invalid priority specification. An unprivileged 
task can not specify a priority which is higher than 
its own execution priority (PSB.PRIE). 

1 1 invalid send buffer address or size (PSB.SBAE) 

12 invalid return buffer address or size (PSB.RBAE) 

13 invalid no-wait mode end action routine address 
(PSB.EAE) 

14 memory pool unavailable (PSB.MPE) 

15 destination task receiver queue is full (PSB.DTQF) 

Bits 16-23 User status — defined by the destination task. 
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Bits 24-31 Options — contains user-request control specification as follows: 

Bit Meaning if Set 

24 request is to be issued in no- wait mode (PSB.NWM) 

25 do not post completion status or accept return 
parameters. This bit is examined only if bit 24 is 
set. When this bit is set, the request was issued 
in the no call back mode. (PSB.NCBM). 


L.15 Resource Create Block (RCB) 

Each H.VOMM entry point that creates a permanent file, a temporary file, a memory 
partition, or a directory may receive a resource create block (RCB) in order to fully 
define the attributes of the resource that is created. RCB formats are described in the 
next three tables. RCBs must be doubleword bounded. 

If an RCB is not supplied by the caller, the resource is created with the default 
attributes described in the MPX-32 Reference Manual Volume I, Chapter 4. 

Permanent and Temporary File Resource Create Block (RCB) 


0 7 8 15 16 23 24 31 


WordO 

1 

File owner name (RCB.OWNR) 

2 

3 

File project group name (RCB. USER) 

4 

Owner rights specifications (RCB.OWRI). See Note 1. 

5 

Project group rights specifications (RCB.UGRI). See Note 1. 

6 

Other’s rights specifications (RCB.OTRI). See Note 1. 

7 

Resource management flags (RCB.SFLG). See Note 2. 

8 

Maximum extension increment (RCB.MXEI). See Note 3. 

9 

Minimum extension increment (RCB.MNEI). See Note 4. 

10 

Maximum file size (RCB.MXSZ). See Note 5. 

11 

Original file size (RCB.OSIZ). See Note 6. 

12 

File starting address (RCB.ADDR). See Note 7. 

13 

File RID buffer (RCB.FAST). See Note 8. 

14 

Option flags (RCB.OPTS). See Note 9. 

15 

Default override (RCB.FREE). See Note 10. 
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Notes: 

1. Rights specifications are optional: 

Bit Description 

0 read access allowed (RCB .READ) 

1 write access allowed (RCB. WRIT) 

2 modify access allowed (RCB. MODI) 

3 update access allowed (RCB.UPDA) 

4 append access allowed (RCB.APPN) 

9 delete access allowed (RCB.DELE) 

2. Resource management flags. For any bit not set, system defaults apply and, in 
some cases, the default is the equivalent of the bit being set (optional): 

Bit Description 

0-7 resource type, equivalent to file type code, interpreted 

as two hexadecimal digits, 0 - FF (RCB.FTYP) 

8-10 reserved 

11 file EOF management required (RCB.EOFM) 

12 fast access (RCB.FSTF) 

13 do not save (RCB . NS A V) 

14 reserved for MPX-32 usage 

15 file start block requested (RCB.SREQ) 

16 file is executable (RCB. EXEC) 

17 owner ID set on access (RCB.OWID) 

18 project group ID set on access (RCB.UGID) 

19 reserved 

20 maximum file extension increment is zero. System 
default value not used. (RCB.MXEF) 

21 minimum file extension increment is zero. System 
default value not used (RCB.MNEF) 

22 reserved 

23 zero file on creation/extension (RCB.ZERO) 

24 file automatically extendible (RCB.AUTO) 

25 file manually extendible (RCB.MANU) 

26 file contiguity desired (RCB.CONT) 

27 shareable (RCB.SHAR) (owner rights spec only) 

28 link access (RCB .LINK) 

29-30 reserved 

31 file data initially recorded as blocked (RCB .BLOK) 

3. Maximum extension increment is the desired file extension increment specified in 
blocks (optional). Default is 64 blocks. 

4. Minimum extension increment is the minimum acceptable file extension 
increment specified in blocks (optional). Default is 32 blocks. 

5. Maximum file size is the maximum extendible size for a file specified in blocks 
(optional). 

6. Original file size is the original file size specified in blocks (optional). Default 
is 16 blocks. 
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7. File starting address is the disk block where the file should start, if possible. If 
the space needed is currently allocated, an error is returned (optional). 

8. File RID buffer is the address within the file creator’s task where the eight word 
resource identifier (RID) is to be returned. If this parameter is not supplied (i.e., 
is zero), the RID for the created file is not returned to the creating task. 

9. Option flags bits are as follows: 

Bit Description 

0 owner has no access rights (RCB.OWNA) 

1 project group has no access rights (RCB.USNA) 

2 others have no access rights (RCB.OTNA) 

10. Default override - If set, these bits override any corresponding bit set in 
RCB.SFLG and the system defaults (optional): 


Bit 

Description 

0-7 

must be zero 

8-10 

reserved 


1 1 file EOF management not required 

12 fast access not required 

13 resource can be saved 

14-22 reserved 

23 do not zero file on creation/extension 

24 file is not automatically extendible 

25 file is not manually extendible 

26 file contiguity is not desired 

27 resource is not shareable 

28-30 reserved 

31 file data initially recorded as unblocked 




S 'V. 
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Directory Resource Create Block (RCB) 

0 7 8 15 16 23 24 31 


Word 0-1 

Directory owner name (RCB.OWNR) 

2-3 

Directory project group name (RCB .USER) 

4 

Owner rights specifications (RCB.OWRI). See Note 1. 

5 

Project group rights specifications (RCB.UGRI). See Note 1. 

6 

Other’s rights specifications (RCB.OTRI). See Note 1. 

7 

Resource management flags (RCB.SFLG). See Note 2. 

8-10 

Reserved 

11 

Directory original size (RCB.OSIZ). See Note 3. 

12 

Directory starting address (RCB.ADDR). See Note 4. 

13 

Directory RID buffer (RCB.FAST). See Note 5. 

14 

Option flags (RCB .OPTS). See Note 6. 

15 

Default override (RCB.FREE). See Note 7. 


Notes: 

1. Rights specifications bits are as follows: 

Bit Description 

0 read access allowed (RCB.READ) 

8 directory may be traversed (RCB.TRAV) 

9 directory may be deleted (RCB.DELE) 

10 directory entries may be deleted (RCB.DEEN) 

1 1 directory entries may be added (RCB. ADEN) 

2. Resource management flags are optional: 

Bit Description 

13 do not save (RCB.NSAV) 

27 shareable (RCB.SHAR) 

3. Directory original size is the number of entries required (optional). 

4. Directory starting address is the disk block number where the directory should 
start, if possible. If the space needed is currently allocated, an error is returned 
(optional). 

5. Directory RID buffer is the address within the directory creator’s task where the 
eight word resource identifier (RID) is to be returned. If this parameter is not 
supplied (i.e., is zero), the RID for the created directory is not returned to the 
creating task. 


MPX-32 Reference 


L-63 




Resource Create Block (RCB) 


6. Option flags are as follows: 

Bit Description 

0 owner has no access rights (RCB.OWNA) 

1 project group has no access rights (RCB.USNA) 

2 others have no access rights (RCB.OTNA) 

7. If default override is set, these bits override any corresponding bit set in 
RCB.SFLG and the system defaults (optional). 


Bit 

Description 

0-7 

must be zero 

13 

resource can be saved 

27 

resource is not shareable 


Memory Partition Resource Create Block (RCB) 


0 7 8 15 16 23 24 31 


Word 0-1 

Partition owner name (RCB.OWNR) 

2-3 

Partition project group name (RCB. USER) 

4 

Owner rights specifications (RCB.OWRI). See Note 1. 

5 

Project group rights specifications (RCB.UGRI). See Note 1. 

6 

Other’s rights specifications (RCB.OTRI). See Note 1. 

7 

Resource management flags (RCB.SFLG). See Note 2. 

8-9 

Reserved 

10 

Starting word page number (RCB.PPAG) 

11 

Partition original size (RCB.OSIZ). See Note 3. 

12 

Partition starting address (RCB.ADDR). See Note 4. 

13 

Partition RID buffer (RCB.FAST). See Note 5. 

14 

Option flags (RCB.OPTS). See Note 6. 

15 

Default override (RCB.FREE). See Note 7. 


Notes: 


1. Rights specifications are optional: 

Bit Description 

0 read access allowed (RCB.READ) 

1 write access allowed (RCB.WRIT) 

9 delete access allowed (RCB.DELE) 
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2. Resource management flags are optional: 

Bit Description 

13 do not save (RCB.NSAV) 

3. Partition’s original size is the number of protection granules required. 

4. Partition’s starting address is a 512-word protection granule number in the user’s 
logical address space where the partition is to begin. 

5. Partition’s RID buffer is the address within the partition creator’s task where the 
eight word resource identifier (RID) is to be returned. If this parameter is not 
supplied (i.e., is zero), the RID for the created partition is not returned to the 
creating task. 

6. Option flags are optional: 

Bits Description 

0 owner has no access rights (RCB.OWNA) 

1 project group has no access rights (RCB.USNA) 

2 others have no access rights (RCB.OTNA) 

9 defines a static partition (RCB. ST AT) 

24-31 define memory class (RCB.MCLA). Values are: 

Value Memory Class 

0 S (default) 

1 E 

2 H 

3 S 

7. If set, these bits override any corresponding bit set in RCB.SFLG and the system 
defaults (optional): 

Bits Description 

0-7 must be zero 

13 resource can be saved 
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L.16 Resource Identifiers (RID) 

The fastest means of locating a volume resource (once created) is by its resource 
identifier (must be on a doubleword boundary). The resource identifier has the 
following format: 


0 7 8 15 16 23 24 31 

Word 0-3 

4 

5 

6 
7 


Volume name 


Creation date 


Creation time 


Volume address of resource descriptor 


Must contain zero 


Resource type 


Since the resource identifier contains the volume address of the resource descriptor, 
the resource descriptor (which points to and describes the resource) can be accessed 
directly without going through the various directories which would otherwise have to 
be traversed. 

Given a valid pathname defining a resource, the corresponding resource descriptor 
may be retrieved by the H.VOMM locate resource service. The first eight words of a 
resource descriptor consist of the resource identifier. 
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L.17 Resource Logging Block (RLB) 

The resource logging block (RLB) is a word-bounded data structure used to pass 
information between H.VOMM and the caller. The information is used to locate a 
directory entry and resource descriptor for a single resource or for all resources 
defined in a particular directory. 


0 7 8 15 16 23 24 31 


WordO 

Pathname vector or RID address (RLB.TGT) 

1 

Resource directory buffer address (192W) (RLB.BUFA). See Note 1. 

2 

Associated mounted volume table entry address (RLB.MVTE) 

3 

Parent directory RD block address (RLB.RDAD) 

4 

Type (RLB.TYPE). 
See Note 2. 

Buffer offset (RLB .BOR 7 ) 

5 

Length. 

See Note 3. 

Return buffer address (RLB .DIR A) 

6 

User FCB address (RLB.FCB) 

7 

Rags. 

See Note 4. 

Reserved (RLB.INT) 


Notes: 


1. Optional. If not specified, a resource directory is not returned. 

2. Bits in RLB.TYPE are assigned as follows: 

Bits Meaning if Set 

0 indicates recall (RLB.RECA) 

1-7 reserved 

3. This word contains the address of a buffer and its length in words (the buffer can 
be up to 16 words long). 

4. Bits in the flags byte are assigned as follows: 

Bits Meaning if Set 

0-1 reserved 

2 directory entry and resource descriptor for specified 
directory are returned 

3 root directory 

4 resource is located 

5-7 reserved 


MPX-32 Reference 


L-67 




Resource Requirement Summary (RRS) Entries 


L.18 Resource Requirement Summary (RRS) Entries W 

The resource requirement summary (RRS) is a doubleword bounded data structure 
used to identify the resources required by a task to the resource manager. Resources 
are statically allocated using the information in the RRS entry. The RRS is generally 
built by processors requiring static allocation of resources, such as TSM, cataloger, 
etc., or supplied as an argument for dynamic allocatioa 

For compatibility purposes, revision 1.x RRS formats can be used. The details of these 
formats can be found in Chapter 2 of a revision 1.x Technical Manual. 

Type 1 - Assign by Pathname 


WordO 

1 


2 

3 

4 -n 


Type 2 - Assign to Temporary File 

0 78 15 16 23 24 31 

WordO 
1 


2 

3 

4-7 


Zero 


Logical file code (RR.LFC) 


Type 

(RR.TYPE). 
See Note 1. 


Size 

(RR.SIZE) 


Initial file size 
(RR.PLEN) 


Access (RR.ACCS). See Note 3. 


Options (RR.OPTS). See Note 4. 


Volume name (16 characters; left-justified, blank-filled) (RR.NAME1) 
(V plume name is optional) 


7 8 


15 16 


Zero 


Logical file code (RR.LFC) 


23 24 


31 


Type 

(RR.TYPE). 
See Note 1. 


Size 

(RR.SIZE) 


Plength 

(RR.PLEN) 


Reserved. 
See Note 2. 


Access (RR.ACCS). See Note 3. 


Options (RR.OPTS). See Note 4. 


Pathname (variable length) (RR.NAME1) 
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Type 3 - Assign to Device 


0 7 8 15 16 23 24 31 


WordO 

Zero 

Logical file code (RR.LFC) 

1 

Type 

Size 

Density 

Zero 


(RR.TYPE). 

(RR.SIZE) 

(RR.DENS). 



See Note 1. 


See Note 5. 


2 

Access (RR.ACCS). See Note 3. 

3 

Options (RR.OPTS). See Note 4. 

4 

Device type 

Volume 

Channel number 

Subchannel 


(RR.DT3). 

number 

See Note 7. 

number 


See Note 6. 

(RR.VLNUM) 

(RR.CHN3) 

(RR.SCHN3) 

5 

Unformatted ID (1-4 characters) (RR.UNFID) 


Type 4 - Assign to LFC 


0 7 8 15 16 23 24 31 


WordO 

Zero 

Logical file code (RR.LFC) 

1 

Type 

(RR.TYPE). 
See Note 1. 

Size 

(RR.SIZE) 

Zero 

2 

Zero 

Logical file code (RR.SFC) 

3 

Options (RR.OPTS). 

See Note 4. 



Type 5 - Assign by Segment Definition 


WordO 

1 

2 

3 

4 

5 


0 7 8 15 16 23 24 31 


Zero 

Logical file code (RR.LFC) 

Type 

Size 

UDT index 

Reserved 

(RR.TYPE). 

(RR.SIZE) 

(RR.UDTI) 


See Note 1. 





Access (RR.ACCS). See Note 3. 


Options (RR.OPTS). See Note 4. 
Starting block number (RR.STBLK) 
Number of blocks (RR.NBLKS) 
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Type 6 - Assign by Resource ID 


0 7 8 15 16 23 24 31 


WordO 

Zero 

Logical file code (RR.LFC) 

1 

Type (RR.TYPE). 
See Note 1. 

Size (RR.SIZE) 

Zero 

Reserved 

2 

Access (RR.ACCS). See Note 3. 

3 

Options (RR.OPTS). See Note 4. 

4-7 

Volume name (16 characters; left-justified, blank-filled) 
(RR.NAME1) 

8 

Binary creation date (RR.DATE) 

9 

Binary creation time (RR.TIME) 

10 

Resource descriptor block address (RR.DOFF) 

11 

Reserved 

Resource type (RR.RTYPE) 


Type 7 - Reserved for Future Use 
Type 8 - Reserved for Future Use 
Type 9 - Mount by Device Mnemonic 



0 7 

8 15 

16 23 

24 31 

WordO 

Zero 

System ID (RR.SYSID). See Note 11. 

1 

Type 

(RR.TYPE). 
See Note 1. 

Size (RR.SIZE) 

Zero 

2 

Access (RR.ACCS). See Note 3. 

3 

Options (RR.OPTS). See Note 4. 

4-7 

Volume name (16 characters; left-justified, blank-filled) 
(RR.NAME1) 

8 

Device type 
(RR.DT9). 
See Note 8. 

Reserved 

Channel number 
(RR.CHN9). 

See Note 9. 

Subchannel 

number 

(RR.SCHN9) 

9 

Zero 
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Type 10 - Assign to ANSI Tape 


15 16 


23 24 


Word 0 Zero Logical file code (RR.LFC) 

1 Type (RR.TYPE). Size (RR.SIZE) Format (RR.FORM) Protect 

See Note 1. (RR.PROT) 

2 Access (RR.ACCS). See Note 3. 

3 Options (RR.OPTS). See Note 4. 

4 Record length (RR.RECL) Block size (RR.BSIZE) 

5 Generation number (RR.GENN) 

6 Generation version number (RR.GENV) 

7 Absolute termination date (RR.EXPIA) 

8 Relative termination date Logical volume identifier (RR.LVID) 

(RR.EXPIR) [___ 

9 RR.LVID (cont.) 

10-13 17-character file identifier (RR.AFID) 

14 RR.AFID (cont.) Reserved 

15 Reserved 


Type 11 - Assign to Shadow Memory 

0 7 8 

Word 0 Zero 

1 Type (RR.TYPE) Size 

See Note 1. [(RR.SIZE) 

2 Start address (RR.SADD) 

3 End address (RR.EADD) 


15 16 


23 24 


Shadow flags 

(RR.SHAD). See Note 10. 


Notes: 

1. Bits in RR.TYPE are assigned as follows: 

Value Meaning 

1 assign by pathname (RR.PATH) 

2 assign to temporary file (RR.TEMP) 

3 assign to device (RR.DEVC) 

4 assign to secondary LFC (RR.LFC2) 

5 assign to segment definition (RR. SPACE) 

6 assign by resource ID (RR.RID) 

7 reserved for future use 

8 reserved for future use 

9 mount by device mnemonic (RR.MTDEV) 

10 assign to ANSI labeled tape (RR.ANS) 

1 1 assign to shadow memory (RR.SHTYP) 

12-255 reserved 
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2. Byte 3 is zero. This field is used by MPX-32 for big blocking buffers. 

3. Bits in RR.ACCS are assigned as follows: 

Bits Meaning if Set 

0 read access allowed (RR.READ) 

1 write access allowed (RR. WRITE) 

2 modify access allowed (RR.MODFY)(not valid for ANSI 
tapes) 

3 update access allowed (RR.UPDAT) 

4 append access allowed (RR.APPND) 

5-15 reserved 

16 explicit shared use requested (RR.SHAR) 

17 exclusive use requested (RR.EXCL) 

18 assign as volume mount device (RR.MNT) 

19-31 reserved 

4. Bits in RR.OPTS are assigned as follows: 

Bits Meaning if Set 

0 treat as SYC file (RR.SYC) (TSM/JOB only) 

1 treat as SGO file (RR.SGO) (TSM/JOB only) 

2 treat as SLO file (RR.SLO) 

3 treat as SBO file (RR.SBO) 

4 explicit blocked option (RR.BLK) 

5 explicit unblocked option (RR.UNBLK) 

6 inhibit mount message (RR.NOMSG) 

7 reserved for system use 

8 automatic open requested (RR.OPEN) 

9 user-supplied blocking buffer address in FCB (RR.BUFF) 

10-11 reserved for system use 

12 mount with no-wait (RR.NOWT) 

13 mount as public volume (RR.PUBLC) 

14 set by H.VOMM for special case handling of VOMM 
assignments (RR.VOMM) 

15 file is spooled when deallocated (RR.SEP) 

16 ANSI labeled tape on RRS type 3 (RR.ANSI) 

17-31 reserved 

5. RR.DENS contains the density specification for XIO high speed tape units. 
When specified, this field has the following bit significance: 

Bits Meaning if Set 

0 indicates 800 bpi nonreturn to zero inverted (NRZI) 

1 indicates 1600 bpi phase encoded (PE) 

6 indicates 6250 bpi group coded recording (GCR) 

If this field is zero, 6250 BPI is set by default. 
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6. RR.DT3 specifies whether or not a channel is present and specifies the device 
type: 

Bits Meaning if Set 

0 channel present 

1-7 device type 

7. RR.CHN3 specifies whether or not a subchannel is present and specifies the 
channel number: 

Bits Meaning if Set 

0 subchannel is present. Examined only if bit zero of 

RR.DT3 is set. 

1-7 channel number 

8. RR.DT9 specifies whether or not a channel is present and specifies the device 
type: 

Bits Meaning if Set 

0 channel present 

1-7 device type 

9. RR.CHN9 specifies whether or not a subchannel is present and specifies the 
channel number: 

Bits Meaning if Set 

0 subchannel is present. Examined only if RR.DT9 is set. 

1-7 channel number 

10. RR.SHAD contains the shadow flags that qualify the start and end addresses, or 
specify what portions of the task are to be shadowed: 

Bits Meaning if Set 

0-7 reserved 

8 shadow the task (RR.SHTSK) 

9 shadow the TSA (RR.SHTSA) 

10 shadow the stack (RR.SHST) 

1 1 shadow memory is required (RR.SHRQ) 

12 shadow the entire task (RR.SHALL) 

13 absolute address (RR.ABS) 

14 relative to the code section origin (RR.CREL) 

15 relative to the data section origin (RR.DREL) 

11. RR.SYSID is the ID for mounting a multiprocessor volume. Valid IDs are: 

Multiported (MP) 0 through F 
Dual Ported (DP) 0 or 1 

For more information on mounting multiprocessor volumes see the MPX-32 
Reference Manual Volume I, Chapter 4, Mounting Multiprocessor Volumes. 
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L.19 Receiver Exit Block (RXB) 

The receiver exit block (RXB) is used to control the return of parameters and status 
from the destination (receiving) task to the task that issued the send request. It is also 
used to specify receiver exit options. The same format RXB is used for both 
messages and run requests. The address of the RXB must be presented as an 
argument when either the M.XMSGR or M.XRUNR services are called. 


WordO 


1 


Notes: 

1. Return status (RXB. ST) contains status as defined by the receiver task. Used to 
set the user status byte in the parameter send block (PSB) of the task which 
issued the send request. 

2. Return parameter buffer address (RXB.RBA) contains the word address of the 
buffer containing the parameters which are to be returned to the task which issued 
the send request 

3. Options (RXB. OPT) contains receiver exit control options. It is encoded as 


follows: 



Value 

Exit Type 

Meaning 

0 

M.XRUNR 

M.XMSGR 

wait for next run request, 
return to point of task interrupt. 

1 

M.XRUNR 

M.XMSGR 

exit task, process any additional 
run requests. If none exist, 
perform a standard exit. 

N/A 

Number of bytes to be returned (RXB.PQ) contains the number of bytes (0 to 
768) of information to be returned to the sending task. 


0 7 8 15 16 23 24 31 


Return status 
(RXB. ST) 

Return parameter buffer address (RXB.RBA) 

Options 
(RXB. OPT) 

Reserved 

Number of bytes to be returned 
(RXB.RQ) 
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L.20 Type Control Parameter Block (TCPB) 

The type control parameter block (TCPB) allows I/O to and from the system console 
by setting up task buffer areas for messages output by a task and optional reads back 
from the console. If no input is desired, word one of the TCPB must be zero. 

See the MPX-32 Reference Manual Volume I, Chapter 5 for further details on the 
TCPB. 


WordO 


1 


2 


Notes: 

1. Bit 12 is set to 1. 

2. Bits in TCP.FLGS are assigned as follows: 

Bits Meaning if Set 

0 no-wait I/O 

31 operation in progress. This bit is reset after post-I/O 

processing completes. 


0 11 12 13 31 


Output quantity 

See 

Output data address 

(TCP.OQ) 

Note 1. 

(TCP.OTCW) 

Input quantity 

See 

Input data address 

(TCP.IQ) 

Note 1. 

(TCP.ITCW) 

Console Teletype Hags 
(TCP.FLGS). See Note 2. 
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Type Control Parameter Block (TCPB) using 24-bit address: 

0 7 8 15 16 23 24 31 


WordO 

Output 

quantity 

(TCP.OQ) 

Output data buffer address (TCP.OTCW) 

1 

Input 

Input data buffer address (TCP.ITCW) 


quantity 



(TCP.IQ) 


2 

Console device flags (TCP.FLGS) See Note 1. 


Notes: 

1. Bit interpretations for TCP.FLGS are: 

Bits Meaning if Set 

0 no-wait I/O 

1 data buffer addresses are 24-bit addresses (TCP.LAD) 

Note: This bit must be set. 

31 operation in progress. This bit is reset after 

post-I/O processing completes. 
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L.21 Unit Definition Table (UDT) 

The unit definition table (UDT) is a system resident structure that identifies device- 
dependent information required by a handler for a specific device. The UDT is built 
by the SYSGEN process, one for each device configured in the system. During 
SYSGEN, each UDT is linked to its corresponding controller definition table (CDT) 
and its associated controller and handler. 


0 7 8 15 16 23 24 31 


WordO 

UDT index (UDT.UDTI) 

CDT index (UDT.CDTI) 

1 

Unit status 
(UDT.STAT). 
See Note 1. 

Device type code 
(UDT.DTC). 

See Note 2. 

Logical 

channel number 
(UDT.CHAN) 

Logical 

subaddress 

(UDT.SUBA) 

2 

Reserved 

Address of dispatch queue entry of task which has 
device allocated if device is not shared (UDT.DQEA) 

3 

Physical channel 
number 

Physical 

subaddress 

Sectors per block 
(UDT.SPB) 

Sectors per 
allocation unit 


(UDT.PCHN) 

(UDT.PSUB) 

or 

number of 

(UDT.SPAU) 

or 




characters 

number of lines per 




per line 
(UDT.CHAR). 
See Note 3. 

screen (UDT.LINE). 
See Note 4. 

4 

Flags 

Number of sectors 

Maximum byte transfer 


(UDT.FLGS). 
See Note 5. 

per track on 
disk or global 
line counter if a 
terminal (UDT.SPT) 

(UDT.MBX) 


5 

Number of sectors on disk or tab setting if a terminal (UDT.SECS) 

6 

Sector size, on disk or a tab 

Number of heads on disk or a tab 


setting if a terminal (UDT.SSIZ) 

setting if a terminal (UDT.NHDS) 

7 

Serial number if tape or removable disk (UDT.SERN). See Note 6. 

8 

Peripheral time-out value (UDT.PTOV) 

9 

Reserved 

Address of device context area (UDT.DCAA) 
or handler name at initialization (UDT.HNAM) 

10 

Bit flags (UDT.BIT2). See Note 7. 

Associated allocated resource 




table index if assigned (UDT.ARTI) 

11 

Service interrupt handler address (UDT.SIHA) 

12 

Reserved 
(UDT.CXR) 
See Note 8. 

Secondary flags 
(UDT.BIT3) 
See Note 9. 

Reserved 

(UDT.SHFL) 

Reserved 

(UDT.DQEN) 



or UDT.HIST. See Note 10 


13 

Address of first IOQ linked to this device (UDT.F10Q) 

14 

Address of last IOQ linked to this device (UDT.BIOQ) 

15 

Link Priority 
(UDT.LPR1) 

Link Count 
(UDT.IOCT) 

Unit Status byte 2 (UDT.STA2). 
See Note 11. 
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Notes: 

1. Bits in UDT.STAT are assigned as follows: 

Bit Meaning if Set 

0 online (UDT.ONLI) 

1 dual-portd XIO disk (UDT.DPDC) 

2 allocated (UDT.ALOC) 

3 terminal in use and not in wait (UDT.USE) 

4 system output unable to allocate (UDT.NOAL) 

5 shared device (UDT.SHR) 

6 premounted (UDT.PREM) 

7 terminal (TSM) device (UDT.TSM) 

2. For example, 01 for any disk, 04 for any tape, etc. Valid device type codes are 
listed in Appendix A. 

3. For disks, contains the number of sectors per block (UDT.SPB). For terminals, 
contains the number of characters per line (UDT. CHAR). 

4. For disks, contains the number of sectors per allocation unit (UDT.SPAU). For 
SLO or terminals, contains the number of lines per page or screen (UDT.LINE). 

5. Bits in UDT.FLGS are assigned as follows: 

Bit Meaning if Set 

0 extended I/O device (UDT.FCLS) 

1 I/O outstanding (UDT.IOUT) 

2 removable disk pack (UDT.RMDV) 

3 a break has been requested for this device (UDT.LOGO) 

4 autoselectable for batch SLO (UDT.BSLO) 

5 autoselectable for batch SBO (UDT.BSBO) 

6 autoselectable for real-time SLO (UDT.RSLO) 

7 autoselectable for real-time SBO (UDT.RSBO) 

6. If the device is a terminal or console, the first halfword is the current terminal 
type for TERMDEF (UDT.CTDF) and the second halfword is the default 
terminal type (UDT.DTDF). 

7. Bits in UDT.BIT2 are assigned as follows: 

Bits Meaning if Set 

0 port is private: else switched (UDT.DIAL) 

1 port is connected to modem (UDT.MODM) 

2 port has graphic capability (UDT.GRFC) 

3 port is full duplex (UDT.FDUX) 

4 port is configured multidrop (UDT.MDRA) 

5 volume mounted on device (UDT. VOL) 

6 echo by computer (UDT.ECHO) 

7 device has failed. Log off TSM (UDT.DEAD) 

8 cache device (UDT.CAC) 

9 inhibit automatic line wrap (UDT.NRAP) 

10 spool device requires form feed after printing rather 
than before; initial form feed is inhibited (UDT.FEOP) 
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Bits Meaning if Set 

1 1 quarter inch cartridge tape drive (UDT.QITD) 

12 software read flow control required (UDT.RXON) 

13 software write flow control required (UDT.WXON) 

14 hardware read flow control required (UDT.RHWF) 

15 hardware write flow control required (UDT.WHWF) 

8. For switched port, contains the value specified in the LOGONFLE CXR = option 
(UDT.CXR) 

9. Bits in UDT.BIT3 are assigned as follows: 

Bits Meaning if Set 

0 SCSI device (UDT.SCSI) 

1-7 reserved 

10. UDT.HIST is used as an address save area by pseudo device handlers, such as 
ON.EPXIO 

11. Bits in UDT.STA2 are assigned as follows: 

Bits Meaning if Set 

0 IOQ linked from UDT (UDT.IOQ) 

1 IOP device (initialized by SYSGEN) (UDT.IOP) 

2 device malfunction (UDT.MALF) 

3 operator intervention applicable (UDT.INTV) 

4 use standard XIO interface 

5 floppy disk 

6 cartridge module drive 

7 moving head disk with fixed head option 

8 if software read flow control enabled, use 

DTR line; otherwise, use RTS line. (UDT.RDTR) 

9 memory disk (UDT.MD) or valid command line recall and 
edit device (UDT.CLRE) 

10 memory allocated for memory disk (UDT.MDAL) 

1 1 start address of memory disk specified at SYSGEN (UDT.MDST) 

12 multiport device is shared with an MPX-32 Revision 3.2C 
or earlier version (UDT.PPV) 

13 device is exclusive ANSI (UDT. ANSI) 

14 serial printer (UDT.SLPR) 

15 port is switched and CXR=N option has been specified 
(UDT.DCXR) 
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Glossary 


access method A software package that provides the ability to access fields 

within records, to classify or order records according to the 
contents of fields, and to perform other such functions. 

access mode Defines the range of operations to be performed on a 

resource. 


aged page A page which has not been referenced within a predetermined 

frame of time during demand page processing. This page is 
no longer considered a part of the task’s working set. 


allocated resource table (ART) 

A system resident table with an entry for each currently 
allocated resource in the system. 

allocation The process of securing a resource for a specific usage and 

access mode for a task. 


allocation unit 


argument 

assign 


assignment 


A mechanism for grouping more than one block on a 
formatted disc, or other mass medium, at one time. Usually 
specified in multiples of 192-word disc blocks. See disc 
block. 

A value (string or integer) that is assigned to a parameter. 

To associate a resource with a logical file code used by a 
process. 

The process of associating a logical file code with a system 
resource. Does not guarantee the resource for a specific use 
or access mode for a task. 


asynchronous Implies one entity does not wait for or otherwise 

acknowledge another entity when it performs an operation. 

asynchronous notification 

A process does not stop execution waiting for notification. It 
receives a software interrupt when an asynchronous operation 
is complete. 

base mode Implies the base register instruction set that allows executable 

programs of up to 4096KW (16MB). 

blocked I/O The process of packing records equal to or less than 254 

bytes so that more than one record is stored in a 192-word 
disc block. 

blocking buffers Buffers used for packing records for blocked I/O. See 

blocked I/O. 
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caller notification packet (CNP) 

A structure used to supply additional calling parameters and 
to control the handling of abnormal conditions that may occur 
during resource requests. 

classes of users A three-level grouping of users into OWNER, 

PROJECTGROUP and OTHER. Used to permit or limit 
access to a resource by ’class’. 

command file A file containing commands known to a particular operating 

system or process. 

CONCEPT/32 A term which implies the entire line of CONCEPT/32 

computers; for example, the 32/67. 

configuration Hardware: the physical hardware related to a CPU. Software: 

adapting the operating system to a hardware configuration 
with the SYSGEN processor. 

data files Files containing data or transactions that have been processed 

or will be processed by a task. 

data management The ability to structure data into records using buffers. 

Datapool An area of memory that contains the same functionality as 

Global Common but with the added flexibility of symbolic 
references being independent of the actual positioning of data 
within the memory area. See Global Common. 

deallocate To detach a resource from a process. 

deassign To remove the association between a logical file code and a 

resource and deallocate the resource. 

dequeue To remove from a prioritized list. 

demand page Allocation of memory when the logical page is referenced by 

the task on demand. The process of allocating physical 
memory when pages are referenced and deallocating physical 
memory when pages are no longer active. Pages that are no 
longer active are considered aged and removed from the 
task’s working set. 

device A peripheral unit such as a card reader, a printer, a disc drive, 

or a tape drive. Distinguished from media used with devices. 

device access Levels are physical I/O, logical device I/O, and logical file 

I/O. 

device-dependent I/O Tasks perform operations to a specified device with minimal 

IOCS overhead. 

device-independent I/O Tasks perform I/O operations through the use of operating 

sys tem calls which are independent of the device used to 
perform the operation. 
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direct I/O Tasks perform operations bypassing IOCS and handler 

functions by coding its own handler and attaching it to a 
specific channel. 

directory A list of file names and/or memory partition names. Stored 

on disc like a regular file. Located via a resource descriptor 
for the directory. Directory names are 1 to 16 characters in 
length and valid characters for names are A to Z, 0 to 9, dot 
(.) and underscore ( _ ). 

directory descriptor The resource descriptor for a directory. 

disc block A common unit of measurement (some number of words) 

used to measure file space on formatted media throughout a 
system. The number of words in a block is oriented to the 
most common sector size on discs used with the system. 

DMAP See resource descriptor allocation map. 

dynamic assignment The association of a logical file code with a system resource 

during task execution. 

enqueue To put into a list ordered by software priority. 

exclusive use A resource is not available for use by any other task until that 

resource is deallocated by the using task. Guarantees access 
to a resource, within the access limitations imposed by the 
resource creator, when logical I/O is initiated. 

executable image A file of object code produced by the LINKER/X32. 

explicit shared use A resource can be used concurrently by more than one task. 

Each task maintains resource integrity by establishing its own 
synchronization and locking mechanisms. Each task is 
guaranteed access to the resource, within access limitations 
imposed by the resource creator, when logical I/O is initiated. 

extended code That part of the operating system that has been modified to 

run in the extended execution space. 

extended file control block 

A file control block set up by the user which contains more 
information than the standard file control block. See file 
control block. 

file A set of information stored on a mass medium such as disc or 

tape that is given a unique identity (number and often name) 
and treated as a single entity for processing. 

file control block (FCB) 

Set up by the user to describe logical files within a task. 
Describes attributes of logical I/O operation. 

file descriptor A resource descriptor for a file. 
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file identifier A unique identifier stored in the resource descriptor for a file 

when the file is created. Used to access the resource 
descriptor without a directory search. 

file segment Set of contiguous allocation units on a volume identifying the 

space associated with a file. Each file segment definition 
contains the absolute 192- word block volume segment 
address and the segment length in 192-word blocks 
(maximum of 32 file segment definitions per file). 


file space allocation map (SMAP) 

A bit map used to allocate space on a volume. 

filename A 1- to 16-character name supplied for a permanent file when 

it is created on a mass medium. Used in most cases thereafter 
to identify the file. Valid characters for filenames are the 
upper-case letters A to Z, the decimal numbers 0 to 9, and the 
special characters dot (.) and underscore ( _ ). Filenames to 
be used with the compatible interfaces, for example Editor, 
File Manager, and Media, are limited to 1 to 8 characters. 

format Standard organization of information. 

formatted volume A disc pack or floppy disc that contains standard volume 

system structures established by the Volume Formatter utility. 


Global Common An area of memory accessible by using symbolic names to 

identify specific storage cells. Programs belonging to many 
independent tasks can freely access the same data and 
exchange control information within the Global Common 
area. 


implicit shared use A resource is available for concurrent use by other tasks in a 

compatible access mode. Does not guarantee access when 
logical I/O is initiated. Resource integrity is automatically 
maintained by the system. 

job file A command file designed to run in the batch or interactive 

environment. 


library file Object modules or source modules identified by name that are 

output to a single file. Modules on library files can be used 
separately and repeatedly. For example, object modules can 
be retrieved by name during cataloging and inserted with 
existing code. The ability to edit the contents of library files 
by name is also normally available. 

load module file A file of object code produced by the Cataloger that is ready 

to relocate from disc into memory and execute as a process. 
Load module files can be activated by name and are 
controlled by name or task number. 
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c 


logical device I/O I/O where the physical characteristics of a device are not 

determined automatically by the file management system 
(device and data formatting are inhibited), allowing the user 
to exert control over a particular physical device or device 
medium. 

logical dismount The action taken by MPX-32 to disassociate a volume from 

the requesting task. A TSM logical dismount disassociates 
the volume from the requesting context. 

logical file code (LFC) User defined 1- to 3-character ASCII codes identifying logical 

files within tasks. 

logical file I/O I/O where the physical characteristics of a device and device 

medium (device format control, data conversion, data 
formatting) are performed automatically for the user so that 
he gains a degree of device independence. 

logical mount The action taken by MPX-32 to associate a physically 

mounted volume to a task. A TSM logical mount associates 
the volume to the TSM context requesting the mount. 

logical resource Any entity existing only because of a mechanism provided by 

software. The primary logical resources are: disc volumes, 
directories, files, and memory partitions. 

map block A 2048-word unit of memory allocation. In demand page 

processing, a page is a map block. 

medium (singular) A contiguous source of input or output that is used for a 

media (plural particular peripheral device. For example, a disc pack is the 

medium mounted on a disc drive; a tape is the medium 
mounted on a tape drive; paper is the medium used on a 
printer, a deck of cards is the medium used on a card reader. 
The operating system distinguishes use of media from use of 
devices. 

memory descriptor The resource descriptor for a memory partition. 

memory partitions Named areas of physical memory that can be shared by 

concurrently executing tasks. 

modular Construction in independent layers. Each higher level layer 

builds on the layer beneath it and provides its own standard 
interfaces to the levels above and below it. 

mounted volume table (MVT) 

A system resident table with an entry for each physically 
mounted volume. Each entry contains information used by 
the system to maintain volume accounting information. 
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multicopied tasks Tasks with the same name and the same concurrent load 

module activity, owned by a single owner or several owners. 
This is accomplished by cataloging a task as multicopy. Task 
numbers must be used to communicate with multicopied 
tasks. See task number. 

multiprocessor volume A specially mounted user volume that allows tasks operating 

in separate system environments to concurrently access any 
volume resource. 


multivolume magnetic tape 

A set of 1 through 255 maximum physical reels of magnetic 
tape processed as a continuous reel. 

nonbase mode Implies the nonbase register instruction set which allows 

executable programs of up to 128KW. 


nonpublic volume A volume assigned specifically to the tasks that mount it. 

Remains physically mounted until use and assign counts 
equal 0. 

object file A file of assembled or compiled code that can be cataloged or 

linked into a task. 


owner 


owner name 


page 


page fault 


The user who has possession of and can control access to a 
file, device, memory partition, or directory. Usually the 
owner of a resource is the user who created its resource 
descriptor. 

A 1- to 8-character name supplied at logon which remains 
unchangeable through logoff. The following characters 
cannot be used in owner names: blanks, commas, semicolons, 
equal signs, line feeds, dollar signs, percent signs, 
exclamation points, and left or right parentheses. All other 
characters are valid. Owner names are associated with any 
task or process activated on the system and noted by any 
process that acts in the owner’s behalf. Owner name is also 
associated with any resources a user creates unless the user 
specifies otherwise. Specifying a different owner when 
creating a resource definition does not change the user’s 
owner name; it only specifies the owner name associated with 
the resource. 

A 512-word unit of memory protection. Also referred to as a 
protection granule. Four pages compose a map block. 

For demand page processing, a page is a map block brought 
into memory and removed from memory during the life of a 
demand page task. 

The reference of a page within the logical address space 
which is not currently a part of the task’s working set. 
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page in 
page out 
parameter 
pathname 

pathname block 

permanent files 
physical dismount 

physical mount 

physical resource 

portable 


Bringing into logical memory a page needed to satisfy an 
address referenced by a task. 

The removal of aged pages from the task’s logical address 
space. 

A symbolic name in a process or directive file that can be 
assigned an argument. 

Variable length ASCII character strings which uniquely 
identify a volume resident resource by explicitly or implicitly 
describing the volume, one or more directories, and the 
resource name. 

Doubleword bounded variable length ASCII character string 
beginning with "!" which uniquely identifies a volume 
resident resource by explicitly or implicitly describing the 
volume, one or more directories, and the resource name. 

Files that remain defined on a volume until explicitly deleted. 

The action taken by MPX-32 to disassociate a volume from 
an assigned mount device and deallocate the device. 

The action taken by MPX-32 to allocate a mount device and 
associate that device to the assigned volume name. 

Any physical hardware that MPX-32 supports. Tasks access 
the resource to perform their functions. The primary physical 
resources are: the CPU, computer memory (main storage), 
and input/output devices. 

Can be used on any compatible device in a single system 
configuration. Can also be carried to a compatible device on 
a different system hardware configuration. Usually describes a 
volume. 


post program-controlled interrupt receiver 

User supplied end-action receiver entered when a hardware 
post program-controlled interrupt is encountered. 

process A body of code scheduled for CPU time as a single entity. A 

load module is a process, in loadable form, stored on disc. 
Same as task. 


project group name A name that is specified at logon and can also be changed. 

Identifies a group of users that have a defined set of rights 
when they access a resource. 

protect To limit access to a resource. See classes of users. 


protection granule A 512-word unit of memory protection. Also referred to as a 

page in a non-demand page context. Four protection granules 
compose a map block. 
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public volume 


real time task 
requestor 


resource 


A volume available for resource assignments by all tasks 
activated in the system. 

Synonymous with time critical process. 

The process which requests a function. Each process on a 
system has an associated owner name. The system process 
that requests a function for a user (e.g., in the interactive 
environment) keeps track of the owner name so that the user 
thinks of himself as the ’requestor’. 

Any source of support that exists external to a task and that 
the task needs to perform its function. A resource can be 
physical or logical. 


resource create block (RCB) 

Defines access attributes for permanent files, temporary files, 
memory partitions, and directories when the particular 
resource is created. If not supplied at resource creation, 
system default attributes are assumed. 




resource descriptor (RD) 

Contains access, accounting, and space definition information 
pertaining to mounted volume resources, permanent files, 
temporary files, directories and partitions. 

resource descriptor allocation map (DMAP) 

A bit map used for the allocation of resource descriptors on a 
volume. 


resource identifier (RID) 

The fastest way to locate an already created volume resource. 
The RID is in the first eight words of a resource descriptor 
and contains the volume address of the resource descriptor, 
which points to and describes the resource. 

resource logging block (RLB) 

A parameter block used as input to the M.LOGR service for 
logging resources. 

Resource Management Module (H.REMM) 

Performs allocation and assignment of all system resources 
and maintains access compatibility and usage rights for these 
resources. Also contains synchronization mechanisms for 
concurrent access to shared resources. 

resource requirement summary (RRS) 

Defines assignment requirements of a resource. Entries are 
variable length, doubleword bounded. There are 9 types of 
entries. 

root directory The directory of all directories defined on a volume. 

SMAP See file space allocation map. 
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source file A file of source code to be assembled or compiled into object 

code. 

static assignment The association of a logical file code with a system resource 

during task activation. 

status posting The process of returning information that indicates whether a 

service was completed successfully, with errors, or denied. 

swap volume A volume used as the primary medium for swap file 

allocations. 

symbolic A representation of a physical resource, e.g., a name that 

represents an entity but is not the entity itself. 

synchronous notification 

A process waits on further processing until it is notified that 
an operation is done or that there is something inhibiting the 
operation (e.g., a resource is not available or other processes 
are in contention for the resource). 

system administrator attribute (SA) 

Gives an unprivileged user the ability to execute privileged 
SVC’s, allows a user to mount public volumes, and allows a 
user to change his owner name. A user with the system 
administrator attribute is, however, restricted to resource 
access limitations imposed by the resource creator. 

system directory Special directory on the system volume which contains 

volume resources necessary for system operation. 

system volume A volume containing the system and bootstrap images from 

which the current system was IPLed. This volume is 
automatically mounted by the SYSINIT task at system 
initialization. 

task Synonymous with process. 

task name The name supplied when a task is cataloged or linked. 

task number An 8-digit hexadecimal number assigned to a task by 

MPX-32 when the task is activated. The task number is 
unique and identifies a particular copy or sharer of a task. 

temporary files Unnamed files that are referenced by resource identifiers. 

They are automatically deleted from the system and their 
volume space made available when the last task assigned to 
them terminates execution. 

time critical process A process which has time constraints. Same as a real time 

task. 

traverse To pass through a directory on the way to another directory 

or resource. 
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type control parameter block (TCPB) 

Set up by the user for sending and receiving messages 
to/from the system console. 

unformatted media A medium (magnetic tape, disc pack or floppy disc) that does 

not contain valid volume format information, but must be 
mounted before initiation of I/O operations. 

usage mode Defines the degree to which multiple tasks can concurrently 

allocate a resource. Usage modes are: exclusive use, explicit 
shared, and implicit shared. 

user A person who uses a system. Processes and commands that 

activate processes are either initiated by a user or initiated on 
behalf of a user. 

volume A medium that has a standard format. Disc packs can be 

formatted as volumes. 

volume assignment table (VAT) 

A task resident table with an entry for each non-public 
volume currently assigned to the task. 

Volume Management Module (H.VOMM) 

Manipulates volume resident and related memory resident 
structures in order to allow for creation, deletion, and 
maintenance of user and system resources which reside on 
volumes; for example, provides space management for all 
currently mounted volumes in the system. 

working set The pages (map blocks) of a task that are actively being 

referenced within a predetermined frame of time. 
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Abort a Task, (Vl)2-46, (Vl)6-16, (Vl)6-50, 
(Vl)7-21, (Vl)7-59, (V2)2-6 
Abort Codes, C-l 

display description, (V2)l-58 
system files, (V3)10-18 
Abort Receiver, (Vl)2-34, (Vl)6-166, 
(Vl)7-170 

Abort Self Service, (Vl)6-17, (Vl)7-22 
Abort Specified Task Service, (V 1)6- 16, 

(VI >7-21 

Abort with Extended Message Service, 
(Vl)6-18, (Vl)7-23 
ACM/MFP 

controller record 

defaults, (V3)10-33 
syntax, (V3)10-33 
initialization format, (V3)10-35 
set dual-channel mode, (Vl)6-142, 
(Vl)7-145 

set single-channel mode, (VI >6-145, 
(Vl)7-148 

true full-duplex operation, (V3)10-37 
Acquire Current Date/Time in ASCII Format 
Service, (Vl)6-138, (Vl)7-139 
Acquire Current Date/Time in Binary 
Format Service, (Vl)6-20, (Vl)7-25 
Acquire Current Date/Time in Byte Binary 
Format Service, (Vl)6-15, (Vl)7-20 
Acquire System Date/Time in Any Format 
Service, (Vl)6-85, (Vl)7-88 
ACS 

CONCEPT 32/67 usage, (V3)12-2 
description, (V3)12-l 
directive summary, (V3)12-5 
DUMPACS 

description, (V3)12-5 
directive summary, (V3)12-5 
directives 

CHECKSUM, (V3)12-6 
COMPARE, (V3)12-6 
DUMP, (V3)12-8 
EXIT, (V3)12-9 
MODE, (V3)12-10 
REVISION, (V3) 12-12 
errors, (V3)12-16 
firmware file, (V3)12-2 
LOADACS 

description, (V3)12-4 
directive file (M.ACS), (V3)12-l 


directive summary, (V3)12-5 
directives 

COPY, (V3)12-7 
ENABLE, (V3)12-8 
LOAD, (V3)12-9 
PATCH, (V3)12-ll 
VERIFY, (V3)12-13 
errors, (V3)12-14 
M.ACS, (V3)12-l 

sample file, (V3)12-13 
Activate a Task, see Task, execution 
Activate Job, (V 1)6-226 
also see Task, execution 
Activate Load Modules, (V3)7-10, (V3)7-50 
Activate Program at Given Time-of-Day 
Service, (Vl)6-185, (Vl)7-187 
Activate Task Interrupt Service, (Vl)6-97, 
(Vl)7-101 

Activate Task Service, (Vl)6-5, (Vl)7-7 
Add 

new users to the system, (V3)10-4 
project group names to the system, 

(V3)10-12 

Advance Record or File Service, (Vl)6-74, 
(Vl)7-9 

AEDDB, (Vl)l-16 
ALIM 

initialization format, (V3)10-26 
terminal record 

defaults, (V3)10-25 
syntax, (V3)10-25 

Allocate, resource, (Vl)5-1, (Vl)5-2, (Vl)5-3, 
(Vl)6-8, (Vl)7-12 

Allocate File or Peripheral Device Service, 

(V 1)6-222 

Allocate File Space Service, (Vl)6-206 
Allocate Resource Descriptor Service, (Vl)6-208 
Allocated Resource Table (ART) 
display, (V4)2-15 
specify size, (V3)7-ll 
Allocation Unit, (Vl)5-55 
Alterable Control Store, see ACS 
Analyze, system tables and queues, (V4)2-3 
ANSI Labeled Tapes 
assign 

LFC, (V2)l-38 
RRS, (Vl)5-12 
dismount, (V2)7-8 
display, (V2)7-10, (V2)7-ll 
examples, (V2)7-6 
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exclude support, (V3)7-40 
file records 

fixed-length, (V2)7-2 
spanned, (V2)7-3 
variable-length, (V2)7-3 
implementation levels, (V2)7-5 
interchange with other systems, (V2)7-4 
labels, (V2)7-4 
LVID, (V2)7-l 
messages, (V2)7-5 
mount, (V2)7-9 
overview, (V2)7-l 
tape drives, (V2)7-3 
usage, (V2)7-2 
utilities 

ADMOUNT, (V2)7-8 
AMOUNT, (V2)7-9 
ASTAT, (V2)7-10 
AVOLM, (V2)7-ll 
J.LABEL, (V2)7-13, (V3) 10-62 
VID, (V2)7-2 

write header labels, (V2)7-13 
Archive, floppy disk, (V4)2-42 
Arithmetic Exception Handling, (Vl)2-34 
Arithmetic Exception Inquiry Service, 

(V 1)6- 182, (Vl)7-184 
ASCII Date/Time to Binary Conversion, 
(Vl)6-28, (Vl)7-34 
ASCII Decimal to Binary Conversion, 
(Vl)6-26, (Vl)7-32 
ASCII Files, display two, (V4)2-24 
ASCII Hex to Binary Conversion, 

(Vl)6-27, (Vl)7-33 
ASCII Interchange Code Set, F-l 
ASMX32, (Vl)l-17 
ASSEMBLE, (Vl)l-16 
Assembler/X32, (Vl)l-17 
Assembly Source Code Flowchart Tool, 
(V4)2-28 
Assign 

arithmetic result to a parameter, 
(V2)l-96 

integer value to a parameter, (V2)l-96 
logical file codes, (V2)l-36 
resource, (Vl)5-2, (Vl)5-3, (Vl)6-8, 
(Vl)7-12 

string value to a parameter, (V2)l-94 
Assign and Allocate Resource Service, 
(Vl)6-8, (Vl)7-12 

Asynchronous Task Interrupt Service, 
(Vl)6-10, (Vl)7-14 
Automatic Batch Job Submission on 
Boot-up, (V4)2-15 
Automatic IPL, (V3)6-4 
Automatic Mounting of Public Volumes, 
(Vl)4-20, (V3)9-l 1 


-B- 

Backspace Record or File Service, 

(Vl)6-ll, (Vl)7-16 
Backspace magnetic tape, (V2)3-22 
Bad Blocks, (Vl)5-64 
Base Mode 

exclude support, (V3)7-40 
nonshared tasks, (Vl)2-3 
system services, (Vl)7-1 
Batch Environment 
accessing, (V2)l-12 
example, (V2)l-109 

Batch Job Entry Service, (Vl)6-13, (Vl)7-18 
Batch Processing 

activate job, (Vl)6-13, (Vl)7-18 
(V2)l-45, (V2)l-59, (V2)l-102, 
(V2)2-8 

change job priority, (V2)l-103 
continuous processing, (V2)2-31, 
(V3)7-36 

example, (V2)l-109, (V2)l-110 
maximum number of active jobs, 
(V3)7-32 

overview, (Vl)l-14 
specify priority level, (V3)7-ll 
terminate input stream, (V2)l-106 
Batch Stream Memory Pool Interaction, 
(V2)l-115 

Binary Date/Time to ASCII Conversion, 
(Vl)6-30, (VI >7-36 
Binary Date/Time to Byte Binary 
Conversion, (V 1)6-33, (Vl)7-39 
Binary to ASCII Decimal Conversion, 

(V 1)6-29, (Vl)7-35 

Binary to ASCII Hexadecimal Conversion, 
(Vl)6-31, (Vl)7-37 

Blocked I/O, (Vl)3-4, (Vl)3-15, (Vl)5-34 
Blocking Buffers, (Vl)3-15 
Boot Block, (VI )4-22 
Booting the System 

from Master SDT, (V3)2-12 

control switches, (V3)2-21, K-l 
from User SDT, (V3)4-4 
Bootstrap program, (V3)5-l 
Bootstrapping, (V3)5-l 
philosophy, (V3)2-22 
Branch 

backward, (V2)l-62 
conditional, (V2)l-64, (V2)l-66, 
(V2)l-69 

forward, (V2)l-63 

Break Key, (Vl)6-60, (Vl)6-65, (Vl)7-68, 
(Vl)7-71, (V2)l-19 
Break/Task Interrupt Link/Unlink 
Service, (Vl)6-19, (Vl)7-24 
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Building SYSGEN Input File 
COMPRESS task, (V3)3-2 
directive input file, (V3)3-l 
object input file, (V3)3-l 
Byte Binary Date/Time to ASCII 
Conversion, (Vl)6-32, (Vl)7-38 
Byte Binary Date/Time to Binary 
Conversion, (Vl)6-34, (Vl)7-40 

C- 

C.TRACE, (V3)7-64 
Caller Notification Packet, see CNP 
Carriage Control Characters, L-31 
Case Sensitivity, TSM, (V2)l-20 
CATALOG 

overlays, (Vl)l-16 
privilege, (Vl)l-15 
CDOT array, specify size, (V3)7-12 
CDT, L-3 

Central Processing Unit, see CPU 
Change 

current working directory, (Vl)6-46, 

(V 1)7-56, (V2)l-48, (V2)l-104 
default system input device, (V2)2-56 
default system output device, (V2)2-56 
directories, (V2)l-ll 
key, (V2)l-9 

owner attributes, (V3)10-7 
password, (V2)l-10 
project group, (VI >6-46, (Vl)7-56, 
(V2)l-ll, (V2)l-48 
project group name key, (V3)10-13 
SBO device, (V2)2-37 
SLO device, (V2)2-37 
tabs, (V4)2-56 

task priority, (Vl)6-131, (Vl)7-131 
Change Defaults Service, (Vl)6-46, Vl)7-56 
Change Priority Level Service, (Vl)6-131, 
(Vl)7-131 

Change Task to Unprivileged Mode Service, 
(V 1)6- 192, (Vl)7-192 
Change Temporary File to Permanent File 
Service, (Vl)6-175, (V 1)6-248, 
(Vl)7-177 

Channel Configuration, (V3)7-13 
Channel Reservation, (Vl)6-153, (V1J7-156 
Channel Reservation Release, (Vl)6-149, 
(Vl)7-153 

Channel Status, display, (V2)2-46 
Check TERMDEF Additions, (V4)2-19 
Clear 

break receiver, (Vl)6-19, (Vl)7-24 
M.KEY file, (V3)10-9 
M.PRJCT file, (V3)10-14 
options, (V2)l-81 
TSM directives, (V2)l-49 


Close File Service, (Vl)6-23, (Vl)7-29 
Close Resource Service, (Vl)6-21, (Vl)7-27 
CNP 

description, (Vl)5-15 

PPCI receiver, (Vl)5-44, (Vl)5-47, L-53 

return conventions, (Vl)5-16 

status posting, (Vl)5-16, (Vl)5-58 

structure, L-2 

Command Line, (Vl)6-24, (Vl)7-30, (V2)l-85, 
(V2)10-l 

Command Line Recall and Edit 
disable, (V2)10-8 
edit, (V2)10-2 
enable, (V2)10-8 
introduction, (V2)10-l 
MPX.PRO file, (V2)10-6 
recall, (V2)10-4 

Common Area, see Memory Partition 
Communicating 

with another task, (V2)l-14, (V2)2-22, 
(V2)2-42 

with other terminals, (V2)l-14 
Communication 
internal, (Vl)l-12 

intertask, (Vl)l-ll, (Vl)2-22, (V2)2-42 
Communications Facilities, (Vl)l-ll 
Compare Program Source Files, 

(V4)2-25 

Compatibility Mode Services 

exclude support, (V3)7-40, (V3)7-61 
COMPRESS 

accessing, (V2)4-l 
at SYSGEN, (V3)7-l 
description, (V2)4-l, (V3)3-2 
error messages, (V2)4-3 
example, (V2)4-4 

logical file codes, (V2)4-2, (V2)4-3 
Compressed Source Format, 1-1 
CONCEPT/32 

interrupts and traps, (Vl)l-5 
machine type, (V3)7-34 
Conditional Branch, (V2)l-64, (V2)l-66, 
(V2)l-69 

Conditional Processing, (V2)l-29 
Configuration Module, (V4)2-18 
Connect Task to Interrupt Level, (V2)2-10 
Connect Task to Interrupt Service, (Vl)6-35, 
(Vl)7-41 
Console 

configuration, (V3)2-l, (V3)7-34 
device definition, (V3)7-21 
Context Switch Timing for M.SURE, 

(V4)2-20 

Continue Task Execution, (V2)l-20, 

(V2)2-ll 

Control Switches, (V3)2-21, K-l 
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Controller Definition Table (CDT), L-3 
Controller Status, display, (V2)2-46 
Convert 

ASCII date/time to binary, (Vl)6-28, 

(V 1)7-34 

ASCII decimal to binary, (Vl)6-26, 
(Vl)7-32 

ASCn hex to binary, (Vl)6-27, (Vl)7-33 
binary date/time to ASCII, (Vl)6-30, 
(Vl)7-36 

binary date/time to byte binary, 

(Vl)6-33, (Vl)7-39 
binary to ASCII decimal, (Vl)6-29, 
(Vl)7-35 

binary to ASCII hexadecimal, (Vl)6-31, 
(V 1)7-37 

byte binary date/time to ASCII, (Vl)6-32, 
(Vl)7-38 

byte binary date/time to binary, (Vl)6-34, 
(Vl)7-40 

date and time formats, (Vl)7-43 
pathname to pathname block, (Vl)6-129, 
(Vl)7-129 

Convert ASCII Date/Time to Byte Binary 
Format Service, (Vl)6-25, (Vl)7-31 
Convert ASCII Date/Time to Standard 
Binary Service, (Vl)6-28, (Vl)7-34 
Convert ASCII Decimal to Binary Service, 
(Vl)6-26, (Vl)7-32 
Convert ASCII Hexadecimal to Binary 
Service, (Yl)6-27, (Vl)7-33 
Convert Binary Date/Time to ASCII Format 
Service, (Vl)6-30, (Vl)7-36 
Convert Binary Date/Time to Byte Binary 
Service, (Vl)6-33, (Vl)7-39 
Convert Binary to ASCII Decimal Service, 
(Vl)6-29, (Vl)7-35 
Convert Binary to ASCII Hexadecimal 
Service, (Vl)6-31, (Vl)7-37 
Convert Byte Binary Date/Time to ASCII 
Service, (Vl)6-32, (Vl)7-38 
Convert Byte Binary Date/Time to Binary 
Service, (Vl)6-34, (Vl)7-40 
Convert Pathname to Pathname Block 
Service, (Vl)6-129, (Vl)7-129 
Convert System Date/Time Format Service, 
(Vl)6-39, (Vl)7-50 

Convert Tape to MPX-32 2.x, (V2)3-23 
Convert Time Service, (Vl)7-43 
Copy a File, (V2)3-25 
CPU 

dispatch queue area, (Vl)2-42 
execution of IPU tasks, (Vl)2-16 
scheduling, (Vl)l-7, (Vl)2-10 
execution priorities, (Vl)2-10 
real-time priority levels, (Vl)2-10 


state chain management, (Vl)2-12 
time-distribution priority levels, 

(Vl)2-ll 

CPU Execution Time 
display, (V2)l-99 
for the task, (Vl)6-204, (Vl)7-206 
Crash Codes, (Vl)2-51, C-32 
Crash Dump Analyzer, (V4)2-3 
Create 

directory, (Vl)4-26, (Vl)6-53, 

(Vl)7-61, (V2)3-32 
FCB, (Vl)5-39, (Vl)7-45 
file, (Vl)4-32, (Vl)6-37, (Vl)6-228, 
(Vl)7-46, (V2)l-50, (V2)3-34 
memory partition, (Vl)4-43, (Vl)6-108, 
(Vl)7-lll, (V2)3-29 
shared image, (Vl)4-45 
temporary file, (Vl)4-41, (Vl)6-173, 
(Vl)6-209, (Vl)7-48 
timer entry, (Vl)6-159, (Vl)7-163 
timer table, (V2)2-58 
Create Directory Service, (Vl)6-53, 

(Vl)7-61 

Create File Control Block Service, (Vl)7-45 
Create Memory Partition Service, 

(Vl)6-108, (Vl)7-lll 
Create Permanent File Service, (Vl)6-37, 
(Vl)6-228, (Vl)7-46 

Create Temporary File Service, (Vl)6-173, 
(Vl)6-209, (Vl)7-48 
Create Timer Entry Service, (Vl)6-159, 
(Vl)7-163 

CSECT, (V 1)2-3, (Vl)3-21 
Current Working Directory 

change, (Vl)6-46, (Vl)7-56, (V2)l-48, 
(V2)l-104 
description, (Vl)4-6 

-D- 

Datapool, (Vl)l-12, (Vl)3-19, (Vl)3-20, 
(V3)7-39 

Datapool Editor, (Vl)l-17 
Date and Time 
conversion 

any format, (Vl)6-39, (Vl)7-43, (Vl)7-50 
ASCII to binary, (Vl)6-28, (Vl)7-34 
ASCII to byte binary, (Vl)6-25, 

(V 1)7-31 

binary to ASCII, (Vl)6-30, (Vl)7-36 
binary to byte binary, (Vl)6-33, 

(Vl)7-39 

byte binary to ASCII, (Vl)6-32, 

(Vl)7-38 

byte binary to binary, (Vl)6-34, 

(V 1)7-40 
display, (V2)2-57 
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formats, H-l 
inquiry 

any format, (Vl)6-85, (Vl)7-84, 
(Vl)7-88 

in ASCT, (Vl)6-44, (Vl)6-138, 
(Vl)7-52, (Vl)7-139 
in binary, (Vl)6-20, (Vl)7-25 
in byte binary, (Vl)6-15, (Vl)7-20 
system update, (V2)2-20 
Date and Time Inquiry Service, (Vl)6-44, 
(Vl)7-52 

Deallocate File or Peripheral Device Service, 
(Vl)6-231 

Deallocate File Space Service, (Vl)6-211 
Deallocate Resource Descriptor Service, 

(V 1)6-2 12 

Deassign and Deallocate Resource Service, 
(Vl)6-42, (Vl)7-53 

Debug Link Service, (Vl)6-123, (Vl)7-207 
Debugger 

execute, (Vl)6-45, (Vl)7-55 
system, see System Debugger 
task 

AIDDB, (Vl)l-16 
specify default, (V3)7-16 
transfer control to, (Vl)6-213, 
(Vl)7-207 

unsupported, (V4)2-44 
DEBUGX32, (Vl)l-18 
Decrease File Size, (V2)3-65 
Default 

SBO device, (V3)7-45 
SID device, (V3)7-51 
SLO device, (V3)7-63 
task debugger, (V3)7-16 
user directory, (V3)10-4 
user project group, (V3)10-4 
user volume, (V3)10-4 
Define FCB Macro, (VI >5-39 
Define Parameters, (V2)l-51 
Delete 

directory, (V2)3-38 
file, (Vl)4-41, (VI >6-232, (V2)l-53, 
(V2)3-39 

memory partition, (VI >4-44, (V 1)6-232, 
(V 2)3-37 

owner from system, (V3)10-9 
project group name from system, 
(V3)10-13 

resources, (Vl)6-48, (Vl)7-57 
SBO file, (V2)2-14 
SLO file, (V2)2-13 
task, (Vl)6-50, (Vl)7-59, (V2)l-20 
from dispatch queue, (V2)2-25 
timer entry, (Vl)6-56, (Vl)7-66 


Delete Permanent File or Non-SYSGEN 
Memory Partition Service, (Vl)6-232 
Delete Resource Service, (Vl)6-48, (Vl)7-57 
Delete Task Service, (Vl)6-50, (Vl)7-59 
Delete Timer Entry Service, (Vl)6-56, 

(V 1)7 -66 

Deliverable Software for MPX-32, (V3)2-3 
Demand Page 

define environment, (V3)7-10, (V3)7-12, 
(V3)7-17, (V3)7-28 
description, (Vl)3-17 
inhibit support, (V3)7-40 
support, (Vl)3-17, (V3)7-10, (V3)7-12 
(V3)7-17, (V3)7-28 
Demonstration 

MPX-32, (V4)l-1 
TERMDEF, (V4)2-28, (V4)2-31 
TSM scanner, (V4)2-59 
Detect File Overlap, (V4)2-27 
Device 

access, (Vl)5-21, (Vl)5-28, A-l 
formatting, (Vl)5-47 

functions, (Vl)5-41, (Vl)5-44, L-27, L-30 
handlers, (V3)7-15 
information display, (V4)2-24 
inquiry, (Vl)6-246 

mnemonics, (Vl)6-52, (Vl)7-60, A-6 
specification, (Vl)5-28, A-l 
status display, (V2)2-46 
type codes, (Vl)6-52, (Vl)7-60, (V3)7-15, 
A-6, L-3, L-77 

Device Initializer/Loader, see DEVINITL 
Device-Dependent I/O, (Vl)5-43 
Device-Independent I/O, (Vl)5-1, (Vl)5-32 
DEVINITL 

activate, (V3)ll-6 
directive file, (V3)ll-1 
directive summary, (V3)ll-7 
directives 

DEV_CNTRL, (V3)ll-8 
DEVICE, (V3)ll-9 
IDENT, (V3)ll-9 
OPTION, (V3)ll-10 
REREAD, (V3)ll-ll 
RETRY, (V3)ll-ll 
WCS_FILE, (V3)ll-12 
errors, (V3)ll-13 
example, (V3)ll-12 
firmware file, (V3)ll-3 
messages, (V3)l 1-13 
Dial-up Port Protection, (V4)2-43 
Direct I/O, (Vl)5-34 
Directive Files 

chaining, (V2)l-27 
errors, (V2)l-28, (V2)l-29 
examples, (V2)l-lll 
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executing tasks, (V2)l-27 
macros, (V2)l-30 
nesting, (V2)l-28 
read from, (V2)l-89 
transfer control, (V2)l-46 
Directives, read from a file, (V2)l-89 
Directory 

access attributes, (Vl)3-9 
change current working, (Vl)6-46, 
(Vl)7-56, (V2)l-48, (V2)l-104 
create, (Vl)4-26, (Vl)6-53, (Vl)7-61, 
(V2)3-32 

current working, (Vl)4-6 
delete, (V2)3-38 
description, (V 1)4-24 
display, (V2)3-44 

log information, (Vl)6-103, (Vl)7-106 
protection, (Vl)4-24, (Vl)4-28 
RCB, (Vl)5-62, L-63 
root, (Vl)4-6, (V 1)4-26 
size allocation, (V2)3-14, (V2)3-15 
structure, (VI >4-6, (VI >4-26 
system, (Vl)5-21 
usage, (VI >4-28 

user default, (V2)l-ll, (V3)10-4 
Disable, logons, (V2)l-54 
Disable Channel Interrupt (DCI or DI), 
(V2)2-15 

Disable Message Task Interrupt Service, 

(V 1)6-59, (Vl)7-67 
Disable User Break Interrupt Service, 
(Vl)6-60, (Vl)7-68 
Discomiect Task from Interrupt Level, 
(V2)2-15 

Disconnect Task from Interrupt Service, 
(Vl)6-55, (Vl)7-63 
Disk Descriptions, (Vl)5-27 
Disk Device Codes, (V3)7-21 
Disk Dump by File, (V4)2-23 
Disk Dump by Sector, (V4)2-22 
Disk Error History, display, (V4)2-24 
Disk Space Usage, (V4)2-26 
Disks, device definitions, (V3)7-19 
Dismount a Volume, (Vl)4-18, (Vl)6-57, 
(Vl)7-64, (V2)l-55, (V2)2-16 
Dismount Volume Service, (Vl)6-57, 

(V 1)7 -64 

Dispatch Queue, (Vl)2-42 
number of entries, (V3)7-26 
Dispatch Queue Entry (DQE), L-5 
Display 

abort code description, (V2)l-58 
active SWAPPER time, (V4)2-53 
allocated resource table, (V4)2-15 
ANSI labeled tape information, (V2)7-10, 
(V2)7-ll 


channel status, (V2)2-46 
communications region, (V4)2-55 
controller status, (V2)2-46 
CPU execution time, (V2)l-99 
date and time, (V2)2-57 
device information, (V4)2-24 
device status, (V2)2-46 
directories, (V2)3-ll, (V2)3-44 
disk error history, (V4)2-24 
disk space usage, (V4)2-26 
file contents, (V2)l-76 
file listing, (V2)3-8, (V2)3-9, (V2)3-42, 
(V2)3-44, (V2)3-46 
GPRs, (V 1)6-61, (Vl)7-69 
inswaps, (V4)2-54, (V4)2-55 
IPU status, (V2)2-46 
IPU traps, (V2)2-26 

job accounting file, (V2)l-33, (V2)2-26 

job queue, (V2)l-99 

load module information, (V4)2-35 

logged on users, (V2)l-99, (V2)l-106 

MDT, (V4)2-35 

memory, (V2)2-46 

memory address and contents, (V2)2-41 
memory limits, (Vl)6-61, (Vl)7-69 
memory partitions, (V2)3-12, (V2)3-13, 
(V2)3-44 

outswaps, (V4)2-54, (V4)2-55 
owners and attributes, (V3)10-9 
project group names, (V3)10-13 
PSD, (V 1)6-61, (Vl)7-69 
rapid file allocation MDT, (V4)2-35 
resources, (V2)3-8, (V2)3-44 
saved files, (V2)3-43 
shared memory includes, (V4)2-54, 

(V4)2-55 

system configuration, (V4)2-18 
system dispatch queue, (V2)2-26 
system output queues, (V2)2-26 
system patch file, (V2)2-26 
tabs, (V4)2-56 
task exit status, (Vl)7-78 
task identification, (Vl)6-88, (Vl)7-91 
task status, (V2)2-26, (V2)2-46 
two ASCII files, (V4)2-24 
UDT entry, (V4)2-60 
volume status, (V2)2-46 
word locations, (V2)2-18, (V2)2-45 
DMAP, (Vl)5-51, (Vl)6-208, (V 1)6-21 2 
DPEDIT, (V 1)1 -17 
DQE, L-5 

DRAM, (Vl)3-16, (V3)7-52, (V3)7-54, (V3)7-55 
DSECT, (Vl)3-21 
Dual-Ported Disk 

release, (Vl)6-142, (Vl)7-145 
reserve, (Vl)6-145, (Vl)7-148 
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Dump, see Display 
Dump Disk File, (V4)2-23 
Dump System-Configured Disk, (V4)2-22 
DUMPACS, see ACS 
Duplicate Floppy Disk, (V4)2-42 
Dynamic Memory Allocation, (Vl)l-8, 
(Vl)3-19 

-E- 

EDIT, (Vl)l-17 

Eight-Line Asynch, see ACM 

Eight-Line Serial Printer, device definition, 

(V 3)7-21 

Eject/Purge Routine Service, (Vl)6-214, 

(Y 1)7-208 

Enable, logons, (V2)l-57 

Enable Channel Interrupt (ECI or El), 

(V2)2-19 

Enable Message Task Interrupt Service, 
(Vl)6-64, (Vl)7-70 
Enable User Break Interrupt Service, 

(V 1)6-65, (Vl)7-71 
End Action Wait Service, (Vl)6-63, 

(Vl)7-15 

End- Action Receivers, (Vl)2-22 
End-of-Job Designation, (V2)l-58 
ENTER CR FOR MORE, (V2)l-21, (V2)l-83, 
(V 3)7-22 

Environments, operating, (V2)l-ll, 

(V2J1-13 

EOF, write, (Vl)6-23, (Vl)6-193, (Vl)6-196, 
(Vl)6-197, (Vl)6-214, (Vl)6-215, 
(Vl)7-29, (Vl)7-195, (Vl)7-198, 
(Vl)7-199, (Vl)7-208, (V 1)7-209 
EOF Management, (Vl)3-12, (Vl)4-49, 
(Vl)5-36, (Vl)5-37 

EOM Management, (Vl)4-50, (Vl)5-36, 
(Vl)5-37 

Erase or Punch Trailer Service, (V 1)6-21 5, 
(Vl)7-209 

Error Codes, unsupported software, (V4)2-60 
Establish a Label, (V2)l-52 
Exception Handler, (Vl)7-158 
Exception Return Address, (Vl)7-157 
Exclude Memory Partition Service, (Vl)6-67 
Exclude Shared Image Service, (Vl)7-73 
Exclusive File Lock 
release, (V 1)6-240 
set, (V 1)6-241 

EXCPM, (V 1)5 -43, (Vl)5-46 
Execute a Task, see Task, execution 
Execute Channel Program, (Vl)5-48, (Vl)7-26 
Execute Channel Program (EXCPM), 
(Vl)5-43, (V 1)5-46 
Execute Chaxmel Program File Control 
Block Service, (Vl)7-26 


Execute Channel Program Service, 

(Vl)6-216, (Vl)7-210 
Exit 

J.MDTI, (V2)5-4 

message end-action routine, (Vl)6-200, 
(Vl)7-202 

message receiver, (Vl)6-201, (Vl)7-203 
no-wait I/O end-action routine, (Vl)6-199, 
(V 1)7-201 
OPCOM, (V2)2-22 
run receiver, (Vl)6-203, (Vl)7-205 
run request end-action routine, (Vl)6-202, 
(Vl)7-204 

task execution, see Task, execution 
TSM, (V2)l-59 
VOLMGR, (V2)3-40 
Exit from Message End-Action Routine 
Service, (Vl)6-200, (Vl)7-202 
Exit from Message Receiver Service, 
(Vl)6-201, (Vl)7-203 

Exit from Run Request End- Action Routine 
Service, (Vl)6-202, (Vl)7-204 
Exit from Task Interrupt Level Service, 

(Vl)6-19, (Vl)6-198, (Vl)7-24, (Vl)7-200 
Exit Run Receiver Service, (Vl)6-203, 
(Vl)7-205 

Exit With Status Service, (Vl)7-78 
Expand Task’s Logical Address Space, 
(V2)l-101 

Extend File Service, (Vl)6-70, (Vl)7-76 
Extended Memory, array, (Vl)6-217, 

(Vl)7-21 1 
Extended MPX-32 

aborts and errors, (Vl)3-29 
CATALOG, (Vl)3-32 
create system, (Vl)3-29 
description, (Vl)3-23 
designate location, (Vl)3-23 
macro assembler, (V 1)3-24 
move the non-base TSA, (V2)l-60 
performance, (Vl)3-23 
physical memory, (Vl)3-25 
program flow control, (Vl)3-27 
relocate, (Vl)3-31 

resident modules, (Vl)3-26, (V3)2-4 
SYSGEN, (Vl)3-27, (Vl)3-28, 

(V3)7-28 

task’s logical address space, (Vl)3-31 
TSM, (Vl)3-33, (V2)l-60 
Extended TSA, (Vl)3-34 
Extendibility, (VI >4-30 

-F- 

Fast Access, (Vl)3-13, (V 1)4-29 
FAT, (Vl)5-20, (Vl)5-51 
Faults, (Vl)2-51 
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FCB 

create, (Vl)5-48, (VI >7-45 
define, (Vl)5-39 
description, (Vl)5-2, (Vl)5-38 
structure 

16-word, L-20 
compatible (8-word), L-32 
high speed data, L-39 
FHD Port 

release, (Vl)6-219, (Vl)7-212 
reserve, (Vl)6-220, (Vl)7-212 
File 

access attributes, (Vl)3-10 

access methods, (Vl)4-34 

access modes, (Vl)4-36 

address inquiry, (Vl)6-234 

allocation, (Vl)6-222 

append mode, (Vl)4-39 

assign temporary, (Vl)4-41, (Vl)5-14 

assignment, (Vl)4-29, (Vl)4-33 

attachment, (Vl)4-29, (Vl)4-33 

attributes, (Vl)4-29 

backspace, (Vl)6-ll, (Vl)7-16 

block, (Vl)4-30 

blocked I/O, (Vl)3-15 

close, (Vl)4-40, (Vl)6-23, (Vl)7-29 

contiguous space, (Vl)4-30 

copy, (V2)3-25 

create permanent, (Vl)4-32, (Vl)6-37, 

(Vl)6-228, (Vl)7-46, (V2)l-50, (V2)3-34 
create temporary, (Vl)4-41, (Vl)6-173, 
(Vl)6-209, (VI >7-48 
deallocate, (Vl)6-231 
delete permanent, (Vl)4-41, (Vl)6-232, 
(V2)l-53, (V2)3-39 
delete temporary, (V 1)4-42 
description, (Vl)4-29 
detach permanent, (V 1)4-41 
detach temporary, (V 1)4-42 
display contents, (V2)l-76 
display listing, (V2)3-42, (V2)3-44, 

(V2)3-46 

EOF management, (Vl)3-12 
extension 

automatic, (Vl)3-ll, (Vl)4-31 
contiguous, (Vl)3-ll 
manual, (Vl)3-ll, (Vl)4-31 
maximum, (Vl)3-12 
minimum, (Vl)3-12 
fast access, (Vl)3-13, (Vl)4-29, 

(Vl)4-31 

granularity, (Vl)4-30 
increase size, (V2)3-41 
log information, (Vl)6-103, (V 1)6-244, 
(Vl)7-106 

management, see File Management 


modify mode, (Vl)4-38 
multiprocessor, (VI) 1-9 
names, (Vl)4-31 
no-save, (Vl)3-14 

open permanent, (Vl)4-29, (Vl)4-34, 
(Vl)6-236 

open temporary, (V 1)4-42 
operations, (Vl)4-34 
permanent, (Vl)l-8, (VI )4-29, (Vl)4-32 
positioning 

absolute, (Vl)4-36 
relative, (Vl)4-36 
print, (V2)l-84 
protection, (Vl)l-9, (VI >4-32 
random access, (Vl)l-9, (Vl)4-35 
rapid allocation, (V2)5-l 
RCB, (Vl)5-59, L-60 
read mode, (Vl)4-37 

rename, (Vl)6-143, (Vl)7-146, (V2)l-87, 
(V2)3-47 

replace contents, (Vl)6-144, (Vl)7-147 
restore from tape, (V2)3-48, (V2)3-53 
rewind, (Vl)6-154, (Vl)7-149 
save, (V2)3-54, (V2)3-57 
segment definition, (Vl)5-55 
sequential access, (Vl)4-35 
shared, (Vl)3-12, (Vl)4-40 
size allocation, (Vl)3-12, (Vl)4-30, 
(Vl)4-31, (Vl)5-55, (V2)3-14, 
(V2)3-15, (V2)3-65 
size extension, (Vl)4-30, (V 1)6-70, 
(Vl)7-76 

sort contents, (V2)8-l 
space, (V 1)4-30, (V 1)4-31 
space allocation, (Vl)6-206, (Vl)6-211 
system, (Vl)l-9 

temporary, (Vl)l-9, (Vl)4-29, (Vl)4-41, 
(Vl)5-14 

temporary to permanent, (Vl)4-42, 
(Vl)6-175, (Vl)6-248, (Vl)7-177 
truncate, (Vl)6-177, (Vl)7-179 
types, (Vl)3-14 
update mode, (Vl)4-39 
write mode, (Vl)4-38 
zeroing, (V 1)3- 13 

File Assignment Table (FAT), (Vl)5-20, 
(Vl)5-51 

File Control Block, see FCB 
File Management 

disk file protection, (VI) 1-9 
multiprocessor files, (Vl)l-9 
permanent files, (VI) 1-8 
random access files, (Vl)l-9 
system files, (Vl)l-9 
temporary files, (Vl)l-9 
File Overlap Detection Utility, (V4)2-27 
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File Pointer Table (FPT), L-46 
Firmware 

display, (V3)12-5 
load (ACS/WCS), (V3)12-4 
load (DEVINITL), (V3)ll-3 
Fixed Head Disk, see FHD 
Flag 

reset (false), (V2)l-88 
set (true), (V2)l-95 
Floppy Disk 

archive, (V4)2-42 
duplication, (V4)2-42 
format, (V4)2-42 
media initialization (J.FORMF), 
(V3)10-42 

Format 

floppy disk, (V3)10-42 
memory disk, (V3) 10-59 
FPT, L-46 

Free Dynamic Extended Indexed Data Space 
Service, (Vl)6-72 

Free Dynamic Task Execution Space Service, 
(Vl)6-73 

Free Memory in Byte Increments Service, 
(Vl)6-lll, (Vl)7-79 
Free Shared Memory Service, (Vl)6-233 
FSORT2 

access, (V2)8-8 
directives 

field, (V2)8-14 
header, (V2)8-13 
usage notes, (V2)8-15 
examples, (V2)8-12, (V2)8-17 
extra memory, (V2)8-7 
format 

blocked, (V2)8-5 
direct access blocked, (V2)8-6 
direct access unblocked, (V2)8-6 
special blocked, (V2)8-6 
special unblocked, (V2)8-6 
unblocked, (V2)8-6 
input data elements, (V2)8-5 
introduction, (V2)8-l 
logical file codes, (V2)8-l, (V2)8-5 
options, (V2)8-7 
subroutines 

SORT:FLD, (V2)8-ll 
SORT:HDR, (V2)8-10 
SORT: PAR, (V2)8-9 
SORT:X, (V2)8-12 

-G- 

Get Address Limits Service, (Vl)6-76, 
(Vl)6-77 

Get Base Mode Task Address Limits 
Service, (Vl)7-103 


Get Command Line Service, (Vl)6-24, 
(Vl)7-30 

Get Current Date and Time Service, 
(Vl)7-84 

Get Definition for Terminal Function 
Service, (Vl)6-81, (Vl)7-81 
Get Device Mnemonic or Type Code 
Service, (Vl)6-52, (Vl)7-60 
Get Dynamic Extended Data Space 
Service, (Vl)6-78 

Get Dynamic Extended Discontiguous Data 
Space Service, (Vl)6-79 
Get Dynamic Task Execution Space Service, 
(Vl)6-80 

Get Extended Memory Array Service, 
(Vl)6-217, (Vl)7-211 
Get Memory in Byte Increments Service, 
(Vl)6-110, (Vl)7-83 

Get Message Parameters Service, (Vl)6-83, 
(Vl)7-86 

Get Real Physical Address Service, 
(Vl)6-139, (Vl)7-140 
Get Run Parameters Service, (Vl)6-84, 
(Vl)7-87 

Get Shared Memory Service, (Vl)6-242 
Get Task Environment Service, (Vl)6-66, 
(Vl)7-72 

Get Task Number Service, (Vl)6-88, 
(Vl)6-118, (Vl)7-91, (Vl)7-120 
Get TSA Start Address Service, (Vl)6-86, 
(Vl)7-89 

Get User Context Service, (Vl)7-80 
Global Common, (Vl)l-ll, (Vl)3-19, 
(Vl)3-20, (V3)7-39 

GPMC Devices, specification, (Vl)5-28 
Granularity, (Vl)4-30 

-H- 

H.ALOC, (Vl)5-50 
H.BKDM, (V 1)5-34 
H.DBUG1, see System Debugger 
H.DBUG2, see System Debugger 
H.ICP, (V4)2-32 
H.MDT, (V3)7-35 
H.MDXIO, (V3)10-58 
H.MONS, (Vl)5-49 
H.MVMT, (Vl)5-22 
H.REMM, (Vl)5-1, (Vl)5-4, (Vl)5-50 
status codes, (Vl)5-17 
H.REXS, (Vl)5-49 
H.VOMM, (Vl)5-20, (Vl)5-51 
status codes, (Vl)5-57 
system services, (Vl)5-65 
Handlers, device, (V3)7-15 
Hardware 

channel configuration, (V3)7-13 
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device characteristics, (V3)10-19 
disk descriptions, (Vl)5-27 
I/O device definitions, (V3)7-18 
machine type configuration, (V3)7-34 
memory disk configuration, (V3)7-13 
minimum configuration, (VI >1-22 
shadow memory configuration, 
(V3)10-56 

starter system addresses, (V3)2-l 
Hardware Interrupts/Traps, (VI) 1-5 
Hardware Priorities, (Vl)l-5 
HELP, (V2)9-l 
Help, online, see Online Help 
HELP, VOLMGR, (V2)3-41 
Help Files 

description, (V2)9-9 
offline, (V2)2-35 
online, (V2)2-36 
specify location, (V3)7-30 
HELPT, (V2)9-l, (V2)9-14 
HSD Interface, FCB settings, L-39 

-I- 

Identify a Job, (V2)l-72 
Implicit Mount Management, (V3)7-13 
Include Memory Partition Service, (Vl)6-90 
Include Shared Image Service, (Vl)7-93 
Increase File Size, (V2)3-41 
Increase Memory Allocation, (V2)l-35 
Indicate Object Records, (V2)l-80 
Indirectly Connected Interrupt Response 
Timing Module, (V4)2-32 
Indirectly Connected Task Linkage Block 
(ITLB), (V3)7-32 
Inhibit 

banner page, (V2)2-31, (V3)7-33, 
(V3)7-36 

demand page, (V3)7-40 
mount message, (V2)l-77, (V2)2-31, 
(V2)2-33, (V3)7-36 
operator intervention, (V2)2-31, 
(V3)7-36, (V3)10-44 
public volume dismount, (V3)7-13 
INIT 

description, (V3)10-19 
errors, (V3) 10-39 
LOGONFLE, see LOGONFLE 
Initial Program Load (IPL), (V3)6-l 
Initialize 

ACM, (V3)10-19 
ACM/MFP, (V3) 10-35 
ALIM, (V3)10-19, (V3) 10-26 
devices (DEVINITL), (V3)ll-1 
disks online, (V3)13-20 
DP II, (V3)13-12, (V3)13-21 
floppy disk, (V3) 10-42 


non-TSM devices, (V3)10-20 
SCSI disk, (V3)13-12, (V3)13-23 
TSM devices, (V3)10-20 
UDP, (V3)13-12, (V3)13-21 
Input/Output, see I/O 

Input/Output Control System (IOCS), (Vl)l-10, 
(Vl)5-1, (Vl)5-38 
Install 

a starter system, (V3)2-l 
a user SDT, (V3)4-3 
INSTALLSDT, (V3)2-17, (V3)2-18 
Instruction Sequence Timing Tool, (V4)2-38 
Integers, powers of, E-l 
Interactive Environment 
accessing, (V2)l-12 
sample task, (V2)l-107 
priority level, (V3)7-62 
Interactive String Search, (V4)2-52 
Interactive Task, (V2)l-25 
Internal Processing Unit, see IPU 
Interrupt Processors, (Vl)2-51, (V3)7-46 
Interrupt, task, see Task, interrupt 
Intertask Communication, (Vl)l-ll, (Vl)2-22, 
(Vl)2-23, (Vl)6-162, (Vl)7-166 
run requests, (Vl)l-ll 
user status word, (Vl)6-155, (Vl)6-183, 
(Vl)7-159, (Vl)7-185 
I/O 

blocked, (Vl)5-34 
device definitions, (V3)7-18 
device-dependent, (Vl)5-43 
device-independent, (Vl)l-10, (Vl)5-1, 

(V 1)5-32 

direct, (Vl)l-10, (Vl)5-34 
direct channel, (Vl)5-43 
file access, (Vl)l-ll 
IOCS, (Vl)l-10 
logical, (Vl)5-1 
logical file codes, see LFC 
no-wait, (Vl)5-33 

processing, (Vl)l-10, (Vl)5-32, (Vl)5-38 
scheduling, (Vl)2-42 
status, (Vl)5-38 

terminate in process, (V2)l-19, (V2)l-27 
wait, (Vl)5-32 

IOCS, (Vl)l-10, (Vl)5-1, (Vl)5-38 
IOQ Memory Pool, specify size, (V3)7-31 
IPL, automatic, (V3)6-4 
IPU 

accounting, (Vl)2-17 
configuration, (V3)7-32 
CPU execution of tasks, (V 1)2- 16 
display status, (V2)2-46 
display traps, (V2)2-26 
executable system services, (Vl)2-18 
base, (Vl)7-5 
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nonbase, (Vl)6-3 
general description, (Vl)2-15 
offline, (V2)2-35 
online, (V2)2-36 
options, (Vl)2-15 
priority versus biasing, (Vl)2-17 
scheduling, (Vl)2-18 
set bias, (VI >6-98, (Vl)7-102 
task prioritization 
biased, (VI >2-15 
nonbiased, (Vl)2-16 
task selection, (V 1)2-1 6 
IPU/CPU Scheduler, (Vl)2-16 
selection, (V3)7-17 

- J- 

J.DSCMP 

description, (V3)14-l 
disk status report, (V3)14-3 
error messages, (V3)14-6 
logical file codes, (V3)14-2 
performance, (V3)14-2 
segment report, (V3)14-3, (V3)14-4 
usage, (V3)14-3 

J.DTSAVE, (V3)7-27, (V3)10-44 
J.FORMF, (V3) 10-42 
J.HLP, (V2)9-l, (V3)7-30 
J.INIT 

conventions, (V3)9-2 
dedicated names, (V3)9-2 
directive summary, (V3)9-3 
directives 

Change Contents of 
Memory Location, (V3)9-3 
Comments, (V3)9-8 
Conditional, (V3)9-6 
Define Base Address, (V3)9-3 
Define Named Value, (V3)9-4 
Define Patch Area, (V3)9-6 
Enter Value into Patch Area, (V3)9-7 
Exit, (V3)9-4 
Go to Patch Area, (V3)9-5 
Return from Patch Area, (V3)9-6 
Select Patch Options, (V3)9-5 
entry conditions, (V3)9-8 
examples, (V3)9-10 
exit conditions, (V3)9-8 
external references, (V3)9-9 
introduction, (V3)9-l 
J .LAB EL, (V3)10-62 
J.MDREST, (V3)10-58, (V3)10-61 
J.MDSAVE, (V3)10-58, (V3)10-60 
J.MDTI 

access, (V2)5-2 
contents, (V2)5-l 
description, (V2)5-l 


errors, (V2)5-8 
examples, (V2)5-6 
exit, (V2)5-4 
input files, (V2)5-4 
logical file codes, (V2)5-3, (V2)5-4 
programming considerations, (V2)5-7 
J.MOUNT, (Vl)l-13 
J.SHAD 

accessing, (V2)6-l 
directives 

EXIT, (V2)6-3 
SHADOW, (V2)6-3 
errors, (V2)6-4 
examples, (V2)6-5 
introduction, (V2)6-l 
logical file codes, (V2)6-2 
J.SHUTD 

error messages, (V3)10-48 
using, (V3)10-45 
J.TDEFI Program, (V2)ll-4 
J.TSET Utility, (V2)ll-21 
J.UNLOCK, (V2)2-58, (V3)10-53 
J.VFMT, (Vl)l-17, (V3)13-l 
access, (V3)13-4 
CONFIRM option, (V3)13-4 
directive syntax, (V3)13-3 
directives 

COPY, (V3)13-5 
EDITFMAP, (V3)13-7 
EXIT, (V3)13-9 
FORMAT, (V3)13-9 
INITIALIZE, (V3)13-12 
NEWBOOT, (V3)13-16 
REPLACE, (V3)13-17 
errors, (V3)13-18 
examples, (V3)13-18 
introduction, (V3)13-l 
logical file codes, (V3)13-l 
media management, see Media 
Management 
usage, (V3)13-2 
JCL 

conditional processing, (V2)l-29 
directive files, (V2)l-27 
directive summary, (V2)l-2 
directive syntax, (V2)l-33 
directives, see TSM, directives 
introduction, (V2)l-1 
macro looping, (V2)l-29 
parameter passing, (V2)l-29 
parameter replacement, (V2)l-30 
spooled input control, (V2)l-30 
Job Accounting File, display, (V2)l-33, 
(V2)2-26 

Job Accounting Program (M.ACCNT), 
(V3)10-15 
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Job Activation, (Vl)6-226 
also see Task, execution 
Job Control Language, see JCL 
Job Identification, (V2)l-72 
Job Number, (V2)2-5 
Job Processing 

data flow, (V2)l-31 
terminating conditions, (V2)l-32 
Job Queue, display, (V2)l-99 

-K - 

Key, (V2)l-9, (V3)10-4 
KEY, (V 1)1 -20, (V3)10-2 

directive summary, (V3)10-4 
directives 

ADD, (V3)10-4 
CHANGE, (V3)10-7 
DEFAULTS, (V3)10-8 
DELETE, (V3)10-9 
LOG, (V3)10-9 
NEWFILE, (V3)10-9 
X, (V3)10-10 
examples, (V3)10-10 
M.KEY file, (V3)10-3 
usage, (V3)10-3 
KEYWORD Task, (V2)l-9 
Kill a Task, (V2)2-25 

- L- 

Label, establish, (V2)l-52 

Label ANSI Tape Utility (J.LABEL), 

(V3) 10-62 

Large Buffers, (Vl)3-15 
Laser Printer Utility, (V4)2-34 
LFC 

assignments, (V2)l-21, (V2)l-36 
in FCB, (Vl)5-38 
overview, (Vl)5-2 
LIBED, (Vl)l-17 
Libraries 

scientific subroutine, (Vl)l-21 
subroutine, (VI) 1-21 
system macro, (VI) 1-21 
user group, (Vl)l-21 
Linker/X32, (Vl)l-18 
LINKX32, ( V 1)1-18 
List, see Display 
LMIT, (V 1)2-7 

Load and Execute Interactive Debugger 
Service, (Vl)6-45, (Vl)7-55 
Load Module Information, (V4)2-35 
Load Module Information Table (LMIT), 
(Vl)2-7 

Load Overlay Segment Service, (V 1)6-12 1 
Load Shared Image into Memory, (V2)2-24 


LOADACS, see ACS 

Log Contents of Rapid File Allocation MDT, 
(V4)2-35 

Log Off the System, (V2)l-14, (V2)l-59 
Log On the System, (V2)l-8 

multiple logons, (V2)l-8, (V3)7-33 
Log Resource or Directory Service, 

(Vl)6-103, (Vl)7-106 
Logged on Users, display, (V2)l-106 
Logical Address 

task boundaries, (Vl)6-76, (Vl)6-77 
verify, (V 1)6- 194, (Vl)7-196 
Logical Channel Program, (Vl)5-43, (Vl)5-44 
Logical Dismount, (Vl)4-18 
Logical File Codes, see LFC 
Logical I/O, (Vl)5-1 
Logical Mount, (Vl)4-18 
Logoff, remote terminal, (V4)2-37 
Logon 

disable, (V2)l-54 
enable, (V2)l-57 
multiple, (V2)l-8, (V3)7-33 
SYSTEM, (V3)7-33, (V3)7-61 
Logon Attempt Coimter, (V3)10-22 
Logon Timeout Counter, (V3) 10-23 
LOGONFLE, (V2)ll-17, (V3)10-20 
format, (V3)10-20 
sample, (V3)10-38 
security counters, (V3) 10-22 
security examples, (V3) 10-24 

-M- 

M.ACCNT File, (V3)10-ll, (V3)10-15 
delete contents, (V2)2-37 
M.ACS, see ACS 
MACTV, (Vl)2-7, (V 1)6-5 
M.ADRS, (Vl)6-6 
M.ALOC, (Vl)6-222 
M.ANYW, (Vl)2-25, (Vl)6-7 
M.ASSN, (Vl)6-8 
M.ASYNCH, (Vl)6-10 
M.BACK, (Vl)6-ll 
M.BATCH, (Vl)6-13, (V4)2-17 
M.BBTIM, (Vl)6-15 
M.BORT, (V 1 )2-46, (Vl)6-16 
M.BRK, (Vl)2-21, (Vl)6-19 
M.BRKXIT, (Vl)2-21, (Vl)6-19 
M.BTIM, (V 1)6-20 
M.CDJS, ( V 1 )6-226 
M.CLOSER, (V 1)6-21 
M.CLSE, (Vl)6-23 
M.CMD, (V 1)6-24 
M.CNTRL File, (V3)10-17 
M.CONABB, (V 1)6-25 
M.CONADB, (Vl)6-26 
M.CONAHB, (Vl)6-27 
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M.CONASB, (VI >6-28 

M.CONBAD, (Vl)6-29 

M.CONBAF, (V 1)6-30 

M.CONBAH, (Vl)6-31 

M.CONBBA, (V 1)6-32 

M.CONBBY, (Vl)6-33 

M.CONBYB, (V 1)6-34 

M.CONN, (Vl)6-35 

M.CPERM, (Vl)6-37 

M.CREATE, (Vl)6-228 

M.CTIM, (Vl)6-39 

M.CWAT, (Vl)6-41 

M.DALC, (Vl)6-231 

M.DASN, (Vl)6-42 

M.DATE, (Vl)6-44 

M.DEBUG, (Vl)6-45 

M.DEFT, (Vl)6-46 

M.DELETE, (Vl)6-232 

M.DELR, (Vl)6-48 

M.DELTSK, (Vl)2-46, (Vl)6-50 

M.DEVID, (Vl)6-52 

M.DIR, (Vl)6-53 

M.DISCON, (Vl)6-55 

M.DLTT, (Vl)6-56 

M.DMOUNT, (Vl)6-57 

M.DSMI, (Vl)6-59 

M.DSUB, (Vl)6-60 

M.DUMP, (Vl)6-61 

M.EAWAIT, (V 1)2-25, (Vl)6-63 

M.ENMI, (V 1)6-64 

M.ENUB, (Vl)6-65 

M.ENVRMT, (Vl)6-66 

M.ERR File, (V3)10-18 

M.EXCL, (Vl)6-233 

M.EXCLUDE, (Vl)3-20, (Vl)6-67 

M.EXIT, (Vl)2-24, (Vl)2-46, (Vl)6-69 

M.EXTD, (Vl)6-70 

M.FADD, (Vl)6-234 

M.FD, (Vl)2-43, (Vl)3-19, (Vl)6-72 

M.FE, (Vl)2-43, (Vl)3-19, (Vl)6-73 

M.FDLE, (Vl)6-236 

M.FSLR, (Vl)6-237 

M.FSLS, (Vl)6-238 

M.FWRD, (Vl)6-74 

M.FXLR, (Vl)6-240 

M.FXLS, (Vl)6-241 

M.GADRL, (Vl)6-76 

M.GADRL2, (Vl)6-77 

M.GD, (Vl)2-43, (Vl)3-19, (Vl)6-78, 

M.GDD, (V 1)6-79 

M.GE, (V 1)2-43, (Vl)3-19, (Vl)6-80 
M.GETDEF, (Vl)6-81, (V2)ll-18 
errors, (V2)ll-19 

M.GMSGP, (Vl)2-22, (Vl)2-24, (Vl)6-83 
M.GRUNP, (Vl)2-22, (Vl)2-24, (Vl)6-84 
M.GTIM, (Vl)6-85 


M.GTSAD, (Vl)6-86 
M.HOLD, (V 1)6-87 
M.ID, (Vl)6-88 
M.INCL, (Vl)6-242 
M.INCLUDE, (Vl)3-20, (Vl)6-90 
M.INQUIRY, (Vl)6-93 
M.INT, (Vl)6-97 
M.IPUBS, (Vl)6-98 
M.KEY Editor, see KEY 
M.KEY File, (Vl)4-13, (V3)10-3 
M.LOC, (Vl)6-99 
M.LOCK, (Vl)6-101 
M.LOG, (Vl)6-244 
M.LOGR, (Vl)6-103 
M.MACLIB, (Vl)l-21 
M.MEM, (V 1)6- 108 

M.MEMB, (Vl)2-43, (Vl)3-19, (Vl)6-110 

M.MEMFRE, (Vl)2-43, (Vl)3-19, (Vl)6-lll 

M.MOD, (Vl)6-112 

M.MODU, (Vl)6-114 

M.MOUNT, (Vl)6-115 

M.MOUNT File, (V3)10-43 

M.MOVE, (Vl)6-117 

M.MPXMAC, (VI) 1-21 

M.MYID, (Vl)6-118 

M.NEWRRS, (V 1)6-1 19 

M.OLAY, (Vl)6-121 

M.OPENR, (Vl)6-122 

M.OSREAD, (Vl)6-124 

M.OSWRIT, (Vl)6-125 

M.PDEV, (Vl)6-246 

M.PERM, (Vl)6-248 

M.PGOD, (Vl)6-126 

M.PGOW, (Vl)6-127 

M.PNAM, (Vl)6-128 

M.PNAMB, (Vl)6-129 

M.PRIL, (Vl)6-131 

M.PRIV, (V 1)6- 132 

M.PRJCT File, (V3)10-ll 

M.PTSK, (Vl)2-7, (Vl)6-133 

M.QATIM, (Vl)6-138 

M.RADDR, (Vl)6-139 

M.RCVR, (Vl)2-22, (Vl)2-23, (Vl)6-140 

M.READ, (Vl)6-141 

M.RELP, (Vl)6-142 

M.RENAM, (Vl)6-143 

M.REPLAC, (Vl)6-144 

M.RESP, (Vl)6-145 

M.REWRIT, (Vl)6-146 

M.REWRTU, (Vl)6-147 

M.ROPL, (Vl)6-148 

M.RRES, (Vl)6-149 

M.RSML, (Vl)6-150 

M.RSRV, (Vl)6-153 

M.RWND, (Vl)6-154 

M.SETS, (Vl)6-155 
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M.SETSYNC, (Vl)6-157 
M.SETT, (Vl)6-159 
M.SHARE, (Vl)6-250 
M.SMSGR, (Vl)2-25, (Vl)6-162 
M.SMULK, (Vl)6-252 
M.SOPL, (Vl)6-163 
M.SRUNR, (Vl)2-26, (Vl)6-164 
M.SUAR, (Vl)2-34, (Vl)6-166 
M.SUME, (Vl)6-167 
M.SURE, (Vl)6-168 

context switch timing, (V4)2-20 
M.SUSP, (Vl)2-25, (Vl)6-169 
M.SYNCH, (Vl)6-170 
M.TBRKON, (Vl)6-171 
M.TDAY, (Vl)6-172 
M.TEMP, (Vl)6-173 
M.TEMPER, (Vl)6-175 
M.TRNC, (Vl)6-177 
M.TSCAN, (Vl)6-178 
M.TSMPC, (V 1)6- 179 
M.TSTE, (Vl)6-182 
M.TSTS, (Vl)6-183 
M.TSTT, (V 1)6- 184 
M.TURNON, (Vl)6-185 
M.TYPE, (Vl)6-187 
M.UNLOCK, (Vl)6-188 
M.UNSYNC, (Vl)6-190 
M.UPRIV, (Vl)6-192 
M.UPSP, (Vl)6-193 
M.USER, (Vl)6-253 
M.VADDR, (Vl)6-194 
M.WAIT, (Vl)6-195 
M.WEOF, (V 1)6-196 
M.WRIT, (Vl)6-197 
M.XBRKR, (Vl)6-198 
M.XIEA, (Vl)2-22, (Vl)6-199 
M.XMEA, (Vl)2-22, (Vl)2-26, (Vl)6-200 
M.XMSGR, (Vl)2-22, (Vl)2-24, (Vl)6-201 
M.XREA, (Vl)2-22, (Vl)2-26, (Vl)6-202 
M.XRUNR, (Vl)2-22, (Vl)2-24, (Vl)6-203 
M.XTIME, (Vl)6-204 
M_ACTV, (Vl)7-7 
M_ADRS, (V 1)7-8 
M_ADVANCE, (V 1)7-9 
M_ANYWAIT, (Vl)7-ll 
M_ASSIGN, (Vl)7-12 
M_ASYNCH, (Vl)7-14 
M_AWAITACTION, (Vl)7-15 
M_BACKSPACE, (V 1)7- 16 
M_BATCH, (Vl)7-18 
M_BBTIM, (Vl)7-20 
M_BORT, (Vl)7-21 
M_BRK, (Vl)7-24 
M_BRKXIT, (Vl)7-24 
M_BTIM, (Vl)7-25 
M_CHANPROGFCB , (Vl)7-26 


M_CLOSER, (Vl)7-27 
M_CLSE, (Vl)7-29 
M_CMD, (Vl)7-30 
M_CONABB, (Vl)7-31 
M_CONADB, (Vl)7-32 
M_CONAHB, (Vl)7-33 
M_CONASB, (Vl)7-34 
M_CONBAD, (Vl)7-35 
M_CONBAF, (Vl)7-36 
M_CONBAH, (Vl)7-37 
M_CONBBA, (Vl)7-38 
M_CONBBY, (Vl)7-39 
M_CONBYB, (V 1)7-40 
M_CONN, (Vl)7-41 
M_CON STRU CTP ATH, (Vl)7-42 
M_CONVERTTIME, (Vl)7-43 
M_CREATEFCB , (Vl)7-45 
M_CREATEP, (Vl)7-46 
M_CREATET, (Vl)7-48 
M_CTIM, (Vl)7-50 
M_CWAT, (Vl)7-51 
M_DATE, (Vl)7-52 
M_DEASSIGN, (Vl)7-53 
M_DEBUG, (Vl)7-55 
M_DEFT, (Vl)7-56 
M_DELETER, (Vl)7-57 
M_DELTSK, (Vl)7-59 
M_DEVID, (Vl)7-60 
M_DIR, (Vl)7-61 
M_DISCON, (Vl)7-63 
M_DISMOUNT, (Vl)7-64 
M_DLTT, (V 1)7-66 
M_DSMI, (Vl)7-67 
M_DSUB, (Vl)7-68 
M_DUMP, (Vl)7-69 
M_ENMI, (V 1)7-70 
M_ENUB, (V 1)7-71 
M_ENVRMT, (Vl)7-72 
M_EXCLUDE, (Vl)7-73 
M_EXIT, (V 1)2-46, (Vl)7-75 
M_EXTENDFILE, (Vl)7-76 
M_EXTSTS, (Vl)7-78 
M_FREEMEMBYTES, (Vl)7-79 
M_GETCTX, (Vl)7-80 
M_GETDEF, (Vl)7-81 
M_GETME MBYTES, (Vl)7-83 
M_GETTIME, (Vl)7-84 
M_GMSGP, (Vl)7-86 
M_GRUNP, (V 1)7-87 
M_GTIM, (Vl)7-88 
M_GTSAD, (Vl)7-89 
M_HOLD, (Vl)7-90 
MJD, (Vl)7-91 
M_INCLUDE, (Vl)7-93 
MJNQUIRER, (Vl)7-96 
M_INT, (Vl)7-101 
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M_EPUBS, (Vl)7-102 
M_LIMITS, (Vl)7-103 
M_LOCK, (Vl)7-104 
M_LOGR, (Vl)7-106 
(Vl)7-lll 
M_MOD, (Vl)7-113 
M_MODU, (Vl)7-115 
M_MOUNT, (Vl)7-116 
M_MOVE, (Vl)7-118 
M_MYID, (Vl)7-120 
M_OPENR, (Vl)7-121 
M_OPTIONDWORD, (Vl)7-124 
M_OPTIONWORD, (Vl)7-125 
M_OSREAD, (Vl)7-126 
M_OSWRIT, (Vl)7-127 
M_PNAMB, (Vl)7-129 
M_PRIL, (Vl)7-131 
M_PRIVMODE, (Vl)7-132 
M_PTSK, (VI >7-133 
M_PUTCTX, (Vl)7-138 
M_QATIM, (VI >7-1 39 
M_RADDR, (Vl)7-140 
M_RCVR, (VI >7-1 41 
M_READ, (VI >7-142 
M_READD, (Vl)7-144 
M_RELP, (Vl)7-145 
M_RENAME, (VI >7-146 
M_REPLACE, (Vl)7-147 
M_RESP, (Vl)7-148 
M_REWIND, (VI >7-149 
M_REWRIT, (VI >7- 150 
M_REWRTU, (VI >7-1 51 
M_ROPL, (Vl)7-152 
M_RRES, (VI >7-1 53 
M_RSML, (Vl)7-154 
M_RSMU, (VI >7-1 55 
M_RSRV, (VI >7- 156 
M_SETERA, (VI >2-37, (Vl)7-157 
M_SETEXA, (VI >2-37, (Vl)7-158 
M_SETS, (VI >7-159 
M_SETSYNC, (VI >7-161 
M_SETT, (Vl)7-163 
M_SMSGR, (VI >7-166 
M_SOPL, (Vl)7-167 
M_SRUNR, (Vl)7-168 
M_SUAR, (Vl)7-170 
M_SUME, (Vl)7-171 
M_SURE, (Vl)7-172 
M_SUSP, (Vl)7-173 
M_SYNCH, (Vl)7-174 
M_TBRKON, (Vl)7-175 
M_TDAY, (Vl)7-176 
M_TEMPFILETOPERM, (Vl)7-177 
M_TRUNCATE, (Vl)7-179 
M_TSCAN, (Vl>7-180 
M_TSMPC, (Vl)7-181 


M_TSTE, (Vl)7-184 
M_TSTS, (Vl)7-185 
M_TSTT, (Vl)7-186 
M_TURNON, (Vl)7-187 
M_TYPE, (Vl>7-189 
M_UNLOCK, (Vl)7-190 
M_UNPRIVMODE, (VI >7- 192 
M_UNSYNC, (VI >7-1 93 
M_UPSP, (VI >7-195 
M_VADDR, (Vl)7-196 
M_WAIT, (Vl)7-197 
M_ WRITE, (Vl)7-198 
M_WRITEEOF, (Vl)7-199 
M_XBRKR, (VI >7-200 
M_XIEA, (VI >7-201 
M_XMEA, (VI >7-202 
M_XMSGR, (VI >7-203 
M_XREA, (VI >7-204 
M_XRUNR, (VI >7-205 
M_XTIME, (VI >7-206 
Machine Type, (V3)2-27, (V3)7-34 
MACLIBR, (Vl)l-16 
Macro Assembler, (VI >1-16 
Macro Directive Files, (V2)l-30 
Macro Librarian/X32, (Vl)l-17 
Macro Libraries, (VI >1-21 
Macro Library Editor, (VI >1-16 
Macro Looping, (V2)l-29 
MACX32, (Vl)l-17 
Magnetic Tape 

advance, (VI >6-74, (Vl)7-9, (V2)3-64, 

(V2)3-65 

backspace, (V2)3-22 
convert, (V2)3-23 
multivolume 

description, (VI >5-22 
write EOF, (VI >6- 193, (VI >6- 196, 
(Vl)6-197, (VI >6-2 14, (Vl)6-215, 
(Vl)7-195, (Vl)7-198, (Vl)7-199, 

(VI >7-208, (VI >7-209 

write volume record, (Vl)6-193, (Vl)6-196, 
(Vl)6-197, (VI >6-2 14, (Vl)6-215, 
(Vl)7-195, (Vl)7-198, (Vl)7-199, 

(VI >7-208, (VI >7-209 
restore files, (V2)3-48, (V2)3-53 
rewind, (V2)3-53 
Map Block, (VI >3- 16 

address assignments, J-l 
Mapped Out, (VI >3-37 

Mapped Programming Executive, see MPX-32 

Master System Distribution Tape, see SDT 

MDT, (V3)7-35 

MEDIA, (Vl)l-19 

Media, unformatted, (VI >5-25 

Media Conversion, (VI >1-19 

Media Flaw Data, (V3) 13-21 


MPX-32 Reference 


IN-15 



Media Flaw Map, (V3)13-23 
Media Management 

during SDT boot, (V3)13-22 
edit media flaw data, (V3)13-21 
EDITFMAP directive, (V3)13-7 
INITIALIZE directive, (V3)13-12 
initialize media, (V3)13-20 
media flaw map, (V3)13-23 
SCSI disks, (V3) 13-23 
terminology, (V3)13-19 
Memory 

deallocate, (Vl)6-lll, (Vl)7-79 
display, (V2)2-46 

physical read, (Vl)6-124, (Vl)7-126 
physical write, (Vl)6-125, (Vl)7-127 
search, (V2)2-41 
shadow, (V2)l-98, (V3)10-54 
Memory Address 
display, (V2)2-41 

get physical, (Vl)6-139, (Vl)7-140 
inquiry, (Vl)6-6, (Vl)7-8 
Memory Address Inquiry Service, (Vl)6-6, 
(Vl)7-8 

Memory Allocation 

blocked I/O, (Vl)3-15 
deallocate map block, (Vl)6-72, 

(V 1)6-73 

demand page, (Vl)3-17 

dynamic, (Vl)l-8, (Vl)3-19 

expand, (Vl)6-80, (Vl)6-110, (Vl)7-83 

extended area, (Vl)6-78, (Vl)6-79 

extended data space, (Vl)3-20 

increase, (V2)l-35 

map block, (Vl)3-16 

MPX-32, (Vl)3-15 

static, (Vl)3-18 

task, (Vl)3-16 

Memory Classes, (Vl)3-16, (V3)10-56 
Memory Disk 

abort cases, (V3)10-59 

access, (V3)10-59 

configuration, (V3)7-13, (V3)10-59 

dismount, (V3)10-59 

errors, (V3)10-60 

format, (V3)10-59 

mount, (V3) 10-59 

overview, (V3)10-58 

restore task (J.MDREST), (V3)10-61 

save task (J.MDSAVE), (V3) 10-60 

usage, (V3)10-59 

Memory Dump Request Service, (Vl)6-61, 
(VI >7-69 

Memory Partition, (V 1)3-20 
access, (Vl)4-44 
access attributes, (Vl)3-10 
attach, (Vl)4-44 


create, (Vl)4-43, (Vl)6-108, (Vl)6-250, 
(Vl)7-lll, (V2)3-29 
Datapool, see Datapool 
define static, (V3)7-39 
delete, (Vl)4-44, (Vl)6-232, (V2)3-37 
detach, (Vl)4-44 
display, (V2)3-44 
dynamic, (Vl)3-18 
exclude, (Vl)6-67 
extended common, (Vl)3-19 
global common, see Global Common 
include, (Vl)6-90, (Vl)6-242 
nonbase addressing, (Vl)4-43 
protection, (Vl)3-10, (Vl)3-20, 

(Vl)4-43 

RGB, (Vl)5-63, L-64 
share, (V 1)4-45 
static, (Vl)3-18 
unlock, (V 1)6-252 
Memory Pool, (V2)l-115 
IOQ size, (V3)7-31 
MSG size, (V3)7-38 
size, (V3)7-46 
system, (Vl)3-15 
Memory Pool Monitor, (V4)2-42 
Memory Resident Descriptor Table (MDT), 
(V2)5-l, (V2)5-7, (V3)7-35 
Memory Size, (V3)7-51 
Memory Types, (Vl)3-16, (V3)10-56 
Memory Word, reset, (V2)2-32 
Message 

end-action processing, (Vl)2-26 
inhibit batch, (V3)7-ll 
maximum no- wait, (V3)7-36 
receive from other tasks, (Vl)2-23, 
(Vl)6-140, (Vl)7-141 
send to console, (Vl)6-187, (Vl)7-189, 
(V3)7-ll 

send to task, (Vl)2-25, (Vl)6-162, 
(Vl)7-166, (V2)2-42 
send to terminal, (V2)l-80, (V2)l-101, 
(V3)7-ll 

system files, (V3)10-18 
Message End-Action Routine Exit, 
(Vl)6-200, (Vl)7-202 
Message Parameters, (Vl)2-24, (Vl)6-83, 
(Vl)7-86 

Message Receiver 
establish, (Vl)2-23 
exit, (Vl)2-24, (Vl)6-201, (Vl)7-203 
Minimum Hardware Configuration, (VI) 1-22 
Modify 

page size, (V2)l-83, (V3)7-21 
screen width, (V2)l-75, (V3)7-21 
Modify Descriptor Service, (Vl)6-112, 
(Vl)7-113 
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Modify Descriptor User Area 
Service, (Vl)6-114, (Vl)7-115 
Modify Swap Parameters, (V4)2-53 
Mount 

memory disk, (V3)10-59 
multiprocessor volume, (VI >4-49 
public volume, (V3)9-ll 
volume, (Vl)4-49, (Vl)6-115, (Vl)7-116, 
(V2)l-77, (V2)2-33 
volume (M.MOUNT), (V3)10-43 
Mount Volume Service, (Vl)6-115, (Vl)7-116 
Move Data to User Address Service, 
(Vl)6-117, (Vl)7-118 
Move Non-base TSA, (Vl)3-28, (Vl)3-32, 
(V2)l-60 
MPX-32 

batch processing, (Vl)l-14 
build, (V3)l-1, (V3)3-l 
command processors, (Vl)l-3 
communications facilities, (Vl)l-ll 
CPU scheduling, (Vl)l-7 
data transfers between revisions, 

(V 1)5 -22 

delimiters, (V2)l-26 

deliverable software, (V3)2-3 

demonstration package, (V4)l-4 

extended, see Extended MPX-32 

features, (VI) 1-3 

file management, (VI) 1-8 

input/output operations, (Vl)l-10 

installation, (V3)2-l 

introduction, (Vl)l-l 

maintenance, (V3)l-1 

mapped in, (V2)l-79 

mapped out, (Vl)3-37, (V2)l-76 

memory allocation, (Vl)l-8, (Vl)3-15 

priority levels, (VI) 1-7 

recovery, (V3)6-l 

restart, (V3)5-l 

shutdown, (V3) 10-45 

software interrupt system, (Vl)l-7 

system administration, (Vl)4-13, (V3)10-l 

system description, (Vl)l-l 

system services, (Vl)l-10, (Vl)6-1, 

(V 1)7-1 
test, (V3)3-l 

time management, (Vl)l-12 
timer scheduler, (VI) 1-1 2 
trap processors, (Vl)l-12 
utilities, see Utilities 
MPX.PRO 

customizing, (V2)10-7 
description, (V2)10-6 
errors, (V2)10-9 
predefined functions, (V2)10-6 
sample file, (V2)10-10 


TSM special keys, (V2)l-15 
MPXDEMO, (V4)l-4 
MSG Memory Pool, specify size, (V3)7-38 
Multicopied Tasks, (Vl)2-3 
Multiprocessor, recovery, (V2)2-58, (V3)10-53 
Multiprocessor Lock, (Vl)4-47 
Multiprocessor Recovery Task (J.UNLOCK), 
(V3)10-53 

Multiprocessor Resource, (Vl)4-47, (Vl)4-51, 
(V3)7-27 

Multiprocessor Shared Memory, (Vl)3-22, 
(V3)7-52, (V3)7-55 

Multiprocessor Shared Volume, (Vl)4-47, 
(Vl)4-49 

Multiprocessor User Volume, (Vl)4-16 
MVT, (Vl)5-51 

-N- 

No-Wait I/O, (Vl)5-33 
No-Wait I/O End-Action Return Service, 
(Vl)6-199, (Vl)7-201 
No-Wait I/O Requests, maximum number, 
(V3)7-36 

No-Wait Messages, maximum number, (V3)7-36 
No-Wait Run Requests, maximum number, 
(V3)7-38 

Nonpubhc Volume, (Vl)4-16 

NULL Device, specification, (Vl)5-28, (V3)7-25 

Numerical Information, D-l 

-O- 

Object Librarian/X32, (Vl)l-18 
Object Records, indicate, (V2)l-80 
OBJX32, (Vl)l-18 
Offline 

device, (V2)2-35 
help files, (V2)2-35 
IPU, (V2)2-35 
Online 

device, (V2)2-36 
help files, (V2)2-36 
IPU, (V2)2-36 

Online Disk Media Management, (V3)13-19 
also see Media Management 
Online Help 

access, (V2)9-3 
choices within, (V2)9-5 
components, (V2)9-l 
description, (V2)9-l 
display sample, (V2)9-2 
errors, (V2)9-15 
help files 

description, (V2)9-9 
offline, (V2)2-35 
online, (V2)2-36 
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specify location, (V3)7-24 
translate, (V2)9-14 
help key, (V2)9-3 
HELPT, (V2)9-l, (V2)9-14 
J.HLP, (V3)7-30 
keywords, (V2)9-2, (V2)9-12 
modify information, (V2)9-8 
print help screen, (V2)9-6 
sample 

display, (V2)9-2 
topic entry, (V2)9-ll 
topic entries, (V2)9-2, (V2)9-10 
translate files, (V2)9-14 
Online Restart, (V3)5-l 
Online System Patch Facility, see UNIT 
OPCOM, (Vl)l-14, (V2)2-l 
activate, (V2)2-3 
batch jobs, (V2)2-5 
directive abort, (V2)2-6 
directive summary, (V2)2-l 
directive syntax, (V2)2-5 
directives 

ABORT, (V2)2-6 
ACTIVATE, (V2)2-7 
BATCH, (V2)2-8 
BREAK, (V2)2-9 
CONNECT, (V2)2-10 
CONTINUE, (V2)2-ll 
DEBUG, (V2)2-12 
DELETETIMER, (V2)2-12 
DEPRINT, (V2)2-13 
DEPUNCH, (V2)2-14 
DISABLE, (V2)2-15 
DISCONNECT, (V2)2-15 
DISMOUNT, (V2)2-16 
DUMP, (V2)2-18 
ENABLE, (V2)2-19 
ENTER, (V2)2-20 
ESTABLISH, (V2)2-21 
EXCLUDE, (V2)2-22 
EXIT, (V2)2-22 
HOLD, (V2)2-23 
INCLUDE, (V2)2-24 
KILL, (V2)2-25 
LIST, (V2)2-26 
MODE, (V2)2-31 
MODIFY, (V2)2-32 
MOUNT, (V2)2-33 
OFFLINE, (V2)2-35 
ONLINE, (V2)2-36 
PURGEAC, (V2)2-37 
REDIRECT, (V2)2-37 
REPRINT, (V2)2-38 
REPUNCH, (V2)2-39 
REQUEST, (V2)2-40 
RESUME, (V2)2-40 


SEARCH, (V 2)2-41 
SEND, (V2)2-42 
SETTIMER, (V2)2-44 
SNAP, (V2)2-45 
STATUS, (V2)2-46 
SYSASSIGN, (V2)2-56 
TIME, (V2)2-57 
TURNON, (V2)2-58 
UNLOCK, (V2)2-58 
WAIT, (V2)2-60 
exit, (V2)2-22 
functionality, (V2)2-l 
job numbers, (V2)2-5 
owner names, (V2)2-4, (V2)2-5 
restrict directives, (V2)2-3 
set system operations, (V2)2-31 
system console, (V2)2-4 
system task restrictions, (V2)2-4 
task names, (V2)2-4 
task numbers, (V2)2-4 
Open, resource, (Vl)5-3 
Open File Service, (Vl)6-236 
Open Resource Service, (Vl)6-122, 

(V 1 >7 - 1 2 1 

Operating Environments, (V2)l-ll, 

(V2)l -13 

Operator Communications, see OPCOM 
Operator Console, see Console 
Operator Intervention Inhibit, (V3)10-44 
Option Word Inquiry, (Vl)6-126, (Vl)6-127, 
(Vl)7-124, (Vl)7-125 
Options 

TSM, see TSM, options 
VOLMGR, see VOLMGR, options 
Others, (Vl)3-6, (Vl)4-40, (V3)7-42 
Overlay, load, (Vl)6-121 
Owner, (V3)7-43, (V3)10-3 
Owner Name, (V2)l-8, (V2)2-4, (V3)10-4 
validation, (Vl)6-218 

-P- 

Page Size, (V2)l-83, (V3)7-21 
Panel Mode Commands, G-l 
Parameter, assign a value, (V2)l-94 
Parameter Passing, (V2)l-29 
Parameter Receive Block (PRB), (Vl)2-32, L-54 
Parameter Replacement 
append a value, (V2)l-30 
macro files, (V2)l-30 

Parameter Send Block (PSB), (Vl)2-27, L-55 
Parameter Task Activation Block (PTASK), 
(Vl)6-134, (Vl)7-134, L-47 
Parameter Task Activation Service, 

(Vl)6-133, (Vl)7-133 
Password, (V2)l-9, (V3)7-44, (V3)10-4 
for terminal ports, (V4)2-43 
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PASSWORD Task, (V2)l-10, (V3)7-49 

Patch Area, (V3)7-45 

Patch Facility, see J.INIT 

Patch File, (V3)7-45 

Pathname, 

execution, (Vl)4-7 
fully qualified, (Vl)4-8, (Vl)4-10 
partially qualified, (Vl)4-9, (VI >4- 11 
reconstruct, (Vl)6-128 
syntax check, (Vl)6-129, (Vl)7-129 
with VOLMGR, (V2)3-15 
Pathname Block (PNB), (Vl)5-52, L-50 
PCB, (Vl)6-180, (Vl)7-182, L-50 
Peripheral Device 
allocate, (Vl)6-222 
deallocate, (Vl)6-231 
Permanent File Address Inquiry 
Service, (Vl)6-234 

Permanent File Log Service, (V 1)6-244 
Permanent Files, see File, permanent 
Physical Channel Program, (Vl)5-43, (Vl)5-44 
Physical Device Inquiry Service, (Vl)6-246 
Physical Dismount, (Vl)4-19 
Physical Memory Read Service, (V 1)6- 124, 
(Vl)7-126 

Physical Memory Write Service, (Vl)6-125, 
(Vl)7-127 

Physical Mount, (Vl)4-17 
PNB, (Vl)5-52, L-50 
Port Protection, (V4)2-43 
Post Program-Controlled Interrupt (PPCI), 
caller notification packet, (Vl)5-47, L-53 
end-action receiver, (Vl)5-44 
Powers of Integers, E-l 
PPCI, (V 1)5 -44, (Vl)5-47, L-53 
PRB, (Vl)2-32, L-54 
Print a File, (V2)l-84 
Printers 

device definition, (V3)7-21, (V3)7-25 
laser support, (V4)2-34 
serial, formatter/spooler, (V4)2-51 
Priority 

change batch job, (V2)l-103 
change task, (Vl)6-131, (Vl)7-131 
increments, (Vl)2-ll 
levels, (Vl)l-7 

batch jobs, (V3)7-l 1 
interactive tasks, (V3)7-62 
migration, (V 1)2-11 
task execution, (Vl)2-10 
Privilege Mode, (Vl)6-132, (Vl)7-132 
Privilege Task, (Vl)6-132, (Vl)7-132 
Process a Different Directive File, (V2)l-46 
Program Development Utilities, (Vl)l-15 
Program Hold Request Service, (Vl)6-87, 
(Vl)7-90 


PROJECT 

directive summary, (V3)10-12 
directives 

ADD, (V3)10-12 
CHANGE, (V3)10-13 
DELETE, (V3)10-13 
LOG, (V3)10-13 
NEWFILE, (V3)10-14 
X, (V3)10-14 
examples, (V3)10-14 
M.PRJCT file, (V3)10-ll 
usage, (V3)10-ll 

Project Group, (V2)l-ll, (V3)7-48, (V3)10-ll 
change, (Vl)6-46, (Vl)7-56, (V2)l-48 
user default, (V3)10-4 
validate, (Vl)6-218 
Protection Granule, (Vl)3-16 
PSB, (Vl)2-27, L-55 
Pseudonym, (V2)2-27 

PTASK Block, (V 1)6- 134, (Vl)7-134, L-47 
Public Volume 

automatic mount, (V3)9-ll 
description, (Vl)4-16 
dismount, (V2)l-55, (V2)2-16 
mount, (V2)l-77, (V2)2-33 
Purge, (Vl)6-214, (Vl)7-208 
Put User Context Service, (Vl)7-138 

-R- 

Random Access, (Vl)l-9, (Vl)4-35 
Rapid File Allocation Utility, see J.MDTI 
RCB 

description, (Vl)5-59, L-60 
directory, (V 1)5 -62, L-63 
file, (Vl)5-59, L-60 
memory partition, (Vl)5-83, L-64 
RDTR, (V2)3-6 

read from tape, (V2)3-46 
Read Descriptor Service, (Vl)6-99, 

(Vl)7-144 

Read Directives, from a file, (V2)l-89 
Read RDTR from Tape, (V2)3-46 
Read Record Service, (Vl)6-141, (Vl)7-142 
Read/Lock Write/Unlock (RLWU), (V3)7-48 
Read/Write Authorization File Service, 

(V 1)6-2 18 
Real-Time Clock 

interrupts per second, (V3)7-39 
interrupts per time unit, (V3)7-42 
Real-Time Environment, accessing, (V2)l-12 
Real-Time Task Accounting, (Vl)2-53, 
(V2)2-31, (V3)7-36 
Realtime Debugger, (V4)2-44 
Recall Command Lines, (V2)l-85, (V2)10-4 
Receive Message Link Address Service, 
(Vl)6-140, (Vl)7-141 
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Receiver Exit Block (RXB), (Vl)2-33, L-74 
Reconstruct Pathname Service, (Vl)6-128, 
(Vl)7-42 

Records 

backspace, (Vl)6-ll, (Vl)7-16 
read, (Vl)6-141, (Vl)7-142 
write, (Vl)6-197, (Vl)7-198 
Recover Multiprocessor, (V2)2-58, (V3)10-53 
Recovering the System, (V3)6-l 
Redirect SLO/SBO Output, (V2)2-37 
Reflective Memory System Software (RMSS), 
(Vl)4-15, (V3)7-41 

Reformat RRS Entry Service, (Vl)6-119 
Reinstate Privilege Mode to Privilege Task 
Service, (Vl)6-132, (Vl)7-132 
Release Channel Reservation Service, 
(Vl)6-149, (Vl)7-153 

Release Dual-Ported Disk/Set Dual-Channel 
ACM Mode Service, (Vl)6-142, 

(Vl)7-145 

Release Exclusive File Lock Service, 
(Vl)6-240 

Release Exclusive Resource Lock Service, 
(Vl)6-188, (Vl)7-190 
Release FHD Port Service, (Vl)6-219, 

(V 1)7 -2 12 

Release Synchronization File Lock Service, 

(V 1)6-237 

Release Synchronous Resource Lock 
Service, (Vl)6-190, (Vl)7-193 
Remote Terminal Logoff, (V4)2-37 
Remove a Job, (V2)l-86 
Remove Shared Image from Memory, 
(V2)2-22 
Rename 

file, (Vl)6-143, (V 1)7- 146, (V2)l-87, 

(V 2)3-47 
volume, (V4)2-44 

Rename File Service, (V 1)6- 143, (Vl)7-146 
Replace Permanent File Service, (Vl)6-144, 
(Vl)7-147 

Reprint SLO, (V2)2-38 
Repunch SBO, (V2)2-39 
Request Interrupt (RI), (V2)2-40, (V2)2-44 
Reserve Channel Service, (Vl)6-153, 
(Vl)7-156 

Reserve Dual-Ported Disk/Set Single- 
Channel ACM Mode Service, 

(Vl)6-145, (Vl)7-148 
Reserve FHD Port Service, (Vl)6-220, 
(Vl)7-212 

Reset a Flag, (V2)l-88 
Reset a Memory Word, (V2)2-32 
Reset Option Lower Service, (Vl)6-148, 
(Vl)7-152 


Resident Executive Services (H.REXS), 

(V 1)5 -49 

Resident Shared Image 
load, (V2)2-24 
remove, (V2)2-22 
Resource Control, (V 1)4-4 
Resource Create Block, see RCB 
Resource Descriptor (RD) 

allocation map, (Vl)6-208, (Vl)6-212 
description, (Vl)4-1, (Vl)4-22, (Vl)5-20, 
(Vl)5-51 

modify, (Vl)6-112, (Vl)7-113 
modify user area, (Vl)6-114, (Vl)7-115 
read, (Vl)6-99, (Vl)7-144 
rewrite, (Vl)6-146, (Vl)7-150 
rewrite user area, (Vl)6-147, (Vl)7-151 
Resource Descriptor Tape Record, see RDTR 
Resource Identifier (RID), (Vl)4-31, (Vl)5-10, 
(Vl)5-55, L-66 

Resource Inquiry Service, (Vl)6-93, 

(Vl)7-96 

Resource Logging Block (RLB), (Vl)6-105, 
(Vl)7-108, L-67 

Resource Management, (Vl)3-1, (Vl)4-1 
dynamic, (Vl)4-1 
static, (VI )4-l 

Resource Management Module, see H.REMM 
Resource Requirement Summary (RRS), 
(Vl)5-4, L-68 

Resourcemark Lock Service, (V 1)6- 150, 
(Vl)7-154 

Resourcemark Table, increase size, (V3)7-49 
Resourcemark Unlock Service, (V 1)7- 155 
Resources 

access, (Vl)3-3 

blocked I/O, (Vl)3-4 
execute channel program, (Vl)3-3 
logical device, (Vl)3-4 
logical file, (V 1)3-4 
access attributes 

directories, (Vl)3-9 
files, (Vl)3-10 
memory partitions, (Vl)3-10 
volumes, (Vl)3-8 

allocate, (Vl)5-1, (Vl)5-2, (Vl)5-3, 
(Vl)6-8, (Vl)7-12 
dynamic, (Vl)3-3 
static, (Vl)3-3, (Vl)3-18 
assign, (Vl)5-1, (Vl)5-2, (Vl)5-3, 

(Vl)5-4, (V 1)6-8, (Vl)7-12 
attach, (Vl)3-2, (Vl)5-2 
attributes, (V 1)3-6 
modify, (Vl)3-5 
protection, (Vl)3-6 
classes, (Vl)4-2 
conflicts, (Vl)5-15 
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create, (Vl)3-2 
deadlock, (VI >4-50 
deallocate, (Vl)6-42, (Vl)7-53 
deassign, (Vl)6-42, (Vl)7-53 
define, (Vl)3-2 

delete, (Vl)3-2, (Vl)6-48, (Vl)7-57 
dequeue, (Vl)4-4 
detach, (VI >3-4 
directory structure, (V 1)4-6 
disk structure, (Vl)4-6 
display listing, (V2)3-44 
enqueue, (Vl)4-4 
error handling, (V 1)5- 15 
exclusive allocation, (Vl)6-101, 

(Vl)6-188, (Vl)7-104, (Vl)7-190 
extension, (Vl)3-ll 
functions, (Vl)3-2 
VO, (Vl)5-1 

inquiry, (Vl)3-5, (Vl)6-93, (Vl)7-96 
log information, (Vl)6-103, (Vl)7-106, 
(V2)3-42, (V2)3-43, (V2)3-44 
logical, (Vl)3-1 
modify attributes, (Vl)3-5 
multiprocessor, (Vl)4-47 
nonshareable, (Vl)4-2 
open, (Vl)5-3, (Vl)5-14, (Vl)6-122, 
(Vl)7-121 

other, (Vl)3-6, (Vl)4-2, (V3)7-42 
owner, (Vl)3-6, (Vl)4-2, (V3)7-43 
pathnames, (V 1)4-7 
physical, (Vl)3-1 
print, (Vl)5-38 

project group, (Vl)3-6, (Vl)4-2, (V3)7-48 
protection, (Vl)4-13 
punch, (Vl)5-38 
shareable, (Vl)3-6, (Vl)4-2 
access control, (Vl)4-5 
exclusive, (Vl)3-7, (Vl)4-3 
explicit, (Vl)3-7, (Vl)4-3 
implicit, (Vl)3-8, (Vl)4-3 
terminate operations, (Vl)6-21, (Vl)7-27 
types, (Vl)3-1, (Vl)4-1 
unformatted media, (Vl)5-25 
user classes, (Vl)3-6, (Vl)4-2 
Restart, (V3)5-l 

Restore files from tape, (V2)3-48, (V2)3-53 
Restrictions, user, (V3)10-4 
Resume Task Execution, (Vl)6-167, (Vl)7-171, 
(V2)2-40 

Resume Task Execution Service, (Vl)6-167, 
(Vl)7-171 

Return Pathname String, (Vl)6-128, 

(Vl)7-42 

Rewind File Service, (Vl)6-154, (Vl)7-149 
Rewind Magnetic Tape, (V2)3-53 


Rewrite Descriptor Service, (Vl)6-146, 
(Vl)7-150 

Rewrite Descriptor User Area Service, 
(Vl)6-147, (Vl)7-151 
RID, (V 1)4-31, (Vl)5-10, (Vl)5-55, L-66 
RLB, (Vl)6-105, (Vl)7-108, L-67 
RMSS, (Vl)4-15, (V3)7-41 
Root Directory, (VI >4-6 
RRS, (Vl)5-4, L-68 
RTOM Interval Timer, (V3)7-32 
Run Receiver, (Vl)2-22, (Vl)2-23 
establish, (Vl)2-23 
exit, (V 1)2-24, (Vl)6-203, (Vl)7-205 
Run Request, (Vl)l-ll 

end-action processing, (Vl)2-26 
exit, (Vl)6-202, (Vl)7-204 
parameters, (Vl)2-24, (Vl)6-84, (Vl)7-87 
send to task, (Vl)2-26, (Vl)6-164, 

(V 1)7- 168 

RXB, (Vl)2-33, L-74 

-S- 

Save Files, (V2)3-54, (V2)3-57 
display, (V2)3-43 
Save Image, directory, (V2)3-4 
Save Tape, (V2)3-l, (V2)3-2 
SBO 

change default device, (V2)2-56 
delete file, (V2)2-14 
logical file code assignment, (V2)l-22, 
(V2)l-36 

output, redirect, (V2)2-37 
repunch files, (V2)2-39 
specify default device, (V3)7-45 
Scan Terminal Input Buffer Service, 
(Vl)6-178, (Vl)7-180 
Scanner Demo, (V4)2-59 
Scheduler, select IPU/CPU, (V3)7-17 
Scheduling 

CPU, see CPU scheduling 
I/O, (Vl)2-42 
IPU, ((V 1)2- 18 
swap, see Swap Scheduling 
task interrupt, (Vl)2-20 
Scratchpad, (V3)7-36 
Screen Logic, TSM, (V2)l-21 
Screen Width, (V2)l-75 
SCSI Disk 

device definition, (V3)7-13 
media management, (V3)13-23 
utility, (V4)2-50 
SDT 
master 

boot from, (V3)2-12 
contents, (V3)2-3 
create, (V2)3-60 
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install, (V3)2-l 
magnetic tape, (V3)2-10 
utility tape, (V3)2-10 
user 

boot from, (V3)4-4 
create, (V2)3-58, (V3)4-l 
install, (V3)4-3 

Search Memory for a Value, (V2)2-41 
Search 

within a file or files, (V4)2-38 
within a source file, 

(V4)2-30, (V4)2-52 
Security, (V3)10-22 

limit logon time, (V3)10-23 
Umit terminal I/O inactivity, (V3)10-23 
LOGONFLE examples, (V3)10-24 
restrict logon attempts, (V3)10-22 
Select Initial Input Source, (V2)l-93 
Select Records 

from a device, (V2)l-90 

from a file, (V2)l-91 

from initial input source, (V2)l-93 

Ubrary format 

from a device, (V2)l-92 
from a file, (V2)l-93 
Send a Message 

to a task, (Vl)6-162, (Vl)7-166, 
(V2)2-42 

to terminal users, (V2)l-I01 
to the console, (Vl)6-187, (Vl)7-189, 
(V3)7-ll 

to user’s terminal, (V2)l-80, (V3)7-ll 
Send Message to Specified Task Service, 
(Vl)6-162, (Vl)7-166 
Send Run Request to Specified Task 
Service, (Vl)6-164, (Vl)7-168 
Sequential Access, (Vl)4-35, (Vl)5-38 
Serial Printer Formatter/Spooler, 

(V4)2-5 1 

Set Asynchronous Task Interrupt Service, 
(Vl)6-10, (Vl)7-14 

Set Exception Handler Service, (Vl)7-158 
Set Exception Return Address Service, 

(V 1)7- 157 

Set Exclusive File Lock Service, (Vl)6-241 
Set Exclusive Resource Lock Service, 
(Vl)6-101, (Vl)7-104 
Set Flag 

false, (V2)l-88 
true, (V2)l-95 

Set EPU Bias Service, (Vl)6-98, (Vl)7-102 
Set Option Lower Service, (V 1)6- 163, 
(Vl)7-167 

Set Synchronization File Lock Service, 
(Vl)6-238 


Set Synchronous Resource Lock Service, 
(Vl)6-157, (Vl)7-161 
Set Synchronous Task Interrupt Service, 
(Vl)6-170, (Vl)7-174 
Set Timer, (V2)2-44 

Set User Abort Receiver Address Service, 
(Vl)6-166, (Vl)7-170 
Set User Status Word Service, (Vl)6-155, 
(Vl)7-159 

SGO, logical file code assignment, (V2)l-22, 
(V2)l-36 
Shadow Memory 
access, (V3)10-57 
allocate task space, (V2)l-98 
assign by RRS, (Vl)5-13 
configurations, (V3)10-54, (V3) 10-56 
error messages, (V3)10-57 
memory classes, (V3)10-56 
overview, (V3)10-54 
SYSGEN error messages, (V3)7-56 
Shadow Utility, see J.SHAD 
Share Memory with Another Task Service, 
(Vl)6-250 
Shared Image 

access, (Vl)4-46 
attach, (VI >4-46 
create, (Vl)4-45 
description, (Vl)l-ll, (V 1)4-45 
detach, (VI >4-46 
exclude, (Vl)7-73 
include, (Vl)7-93 
load into memory, (V2)2-24 
protection, (VI >4-45 
remove from memory, (V2)2-22 
Shared Memory, (Vl)3-21, (V3)7-51 
deallocate, (Vl)6-233 
dynamic partitions, (Vl)3-18 
multiprocessor, (Vl)3-22 
static partitions, (Vl)3-18 
SYSGEN error messages, (V3)7-51 
Shared Memory Table (SMT), (V3)7-51 
Shared Tasks, (Vl)2-3 
SHUTDOWN Macro 

error messages, (V3) 10-49 
introduction, (V3)10-45, (V3)10-46 
modify, (V3)10-47 
usage, (V3)10-46 
SID 

change the default, (V2)2-56 
specify default device, (V3)7-51 
SJ.SWAPR2, (V3) 10-49 
SJ.XX.ER, (V3)10-18 
SLO 

change default device, (V2)2-56 
delete file, (V2)2-13 
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logical file code assignment, (V2)l-22, 
(V2)l-36 
output, (V2)l-103 
redirect, (V2)2-37 
reprint files, (V2)2-38 
specify default device, (V3)7-33 
SYSGEN, title, (V3)7-63 
Small Computer System Interface, 
see SCSI Disk 

SMAP, (Vl)5-51, (Vl)6-206, (Vl)6-211 
Software, unsupported, (V4)2-l 
Software Interrupt System, (VI >1-7 
Software Priorities, (VI) 1-5 
Sort/Merge, see FSORT2 
Source Compare Program, (V4)2-25 
Source Search Tool, (V4)2-30 
Space Allocation, (VI >6-206 
Special Keys, TSM, (V2)l-15 
Split Image, see Extended MPX-32 
Spool Batch Records 

from a device, (V2)l-90 
from a file, (V2)l-91 
library format 

from a device, (V2)l-92 
from a file, (V2)l-93 
Spooled Input 

control, (V2)l-30 
terminating conditions, (V2)l-32 
Spooled Output, see SLO 
Starter System, (V3)2-l 
State Chain 

head cell, (VI >2-12 
queue, (Vl)2-12 
State Chain History, (V4)2-27 
State Queues, (Vl)2-13 
Static Memory Allocation, (Vl)3-18 
Status Codes 

H.REMM, (Vl)5-17 
H.VOMM, (V 1)5-57 
String Search, (V4)2-38 
Submit Batch Job, (V2)l-45, (V2)l-102 
Submit Batch Job on Boot-up, (V4)2-15 
Submit Job from Disk File Service, 
(Vl)6-226 

Subroutine Libraries, (VI) 1-21 
Subroutine Library Editor, (Vl)l-17 
Suspend Task Execution Service, (Vl)6-169, 
(Vl)7-173 

Suspend/Resume Service, (Vl)6-168, 
(Vl)7-172 

SVC Type 1 Table, (V3)7-58 

Swap Device, (V3)7-58 

Swap File Size, (V3)7-46 

Swap Monitor Program, (V4)2-54, (V4)2-55 

Swap Parameter Modifier Program, (V4)2-53 

Swap Quantum, (V3)7-59 


Swap Scheduler 

algorithms, (V3)10-50 
call back swap-on priority only (CB.SOPO), 
(V3)10-51 

description, (V3)10-49 

errors, (V3)10-53 

swap thrash control, (V3)10-51 

task group outswap limits, (V3)10-52 

user set inhibit flag (US.SWIF), 

(V3)10-51 

user set swap-on priority only (US.SOPO), 
(V3)10-51 

wait state ordering, (V3)10-50 
wait state swap-on priority only (SOPO), 
(V3)10-51 

Swap Scheduling, (Vl)2-43 
entry conditions, (Vl)2-43 
exit conditions, (Vl)2-44 
inswap process, (Vl)2-45 
outswap process, (Vl)2-45 
selection of inswap and outswap 
candidates, (Vl)2-44 
structure, (Vl)2-43 

Swapper Percentage Active Monitor, (V4)2-53 
SYC 

description, (V2)l-16 
I/O input limitations, (V2)l-23 
logical file code assignment, (V2)l-21, 
(V2)l-36 

parameter replacement, (V2)l-30 
terminal I/O, (V2)l-23 
Symbol Table File Name, (V3)7-60 
Symbolic Debugger/X32, (Vl)l-18 
Synchronization File Lock 
release, (Vl)6-237 
set, (Vl)6-238 

Synchronized Access, (Vl)6-157, 

(Vl)6-190, (Vl)7-161, (Vl)7-193 
SYSGEN, (Vl)l-20, (V3)3-l, (V3)7-l 
access, (V3)7-4 
description, (V3)7-l 
directive input file, (V3)3-l 
directive summary, (V3)7-4 
directives 

ACTIVATE, (V3)7-10 
AGE, (V3)7-10 
ARTSIZE, (V3)7-ll 
BATCHMSG, (V3)7-ll 
BATCHPRI, (V3)7-ll 
BEGPGOUT, (V3)7-12 
CDOTS, (V3)7-12 
/CHANNELS, (V3)7-13 
CMIMM, (V3)7-13 
CMPMM, (V3)7-13 
CONTROLLER, (V3)7-13 
DBGFBLE, (V3)7-16 
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DEBUGTLC, (V3)7-16 
DELTA, (V3)7-17 
DEMAND, (V3)7-17 
DEVICE, (V3)7-18 
DISP, (V3)7-26 
DPTIMO, (V3)7-27 
DPTRY, (V3)7-27 
DTSAVE, (V3)7-27 
//END, (V3)7-28 
ENDPGOUT, (V3)7-28 
EXTDMPX, (Vl)3-28, (V3)7-28 
/FILES, (V3)7-30 
FLTSIZE, (V3)7-30 
//HARDWARE, (V3)7-30 
HELP, (V3)7-30 
/INTERRUPTS, (V3)7-31 
IOQPOOL, (V3)7-31 
IPU, (V3)7-32 
ITIM, (V3)7-32 
ITLB, (V3)7-32 
JOBS, (V3)7-32 
KTIMO, (V3)7-33 
LOD, (V3)7-33 
LOGON, (V3)7-33 
MACHINE, (V3)7-34 
MAPOUT, (V3)7-35 
MDT, (V3)7-35 
/MEMORY, (V3)7-35 
MMSG, (V3)7-36 
MNWI, (V3)7-36 
MODE, (V3)7-36 
MODULE, (V3)7-37 
/MODULES, (V3)7-38 
MRUN, (V3)7-38 
MSGPOOL, (V3)7-38 
MTIM, (V3)7-39 
NAME, (V3)7-39 
NOANSI, (V3)7-40 
NOBASE, (V3)7-40 
NOCMS, (V3)7-40 
NODEMAND, (V3)7-40 
NOLACC, (V3)7-4I 
NOMAPOUT, (V3)7-41 
NOSYSVOL, (V3)7-41 
NOTDEF, (V3)7-4l 
NOTSMEXIT, (V3)7-42 
NTIM, (V3)7-42 
OTHERS, (V3)7-42 
/OVERRIDE, (V3)7-43 
OWNER, (V3)7-43 
OWNERNAME, (V3)7-44 
/PARAMETERS, (V3)7-44 
/PARTITION, (V3)7-44 
PASSWORD, (V3)7-44 
PATCH, (V3)7-45 
PCHFILE, (V3)7-45 


POD, (V3)7-45 
POOL, (V3)7-46 
PRIORITY, (V3)7-46 
PROGRAM, (V3)7-47 
PROJECT, (V3)7-48 
RLWU, (V3)7-48 
/RMSTABLS, (V3)7-49 
RMTSIZE, (V3)7-49 
SAPASSWD, (V3)7-49 
/SECURITY, (V3)7-49 
SEQUENCE, (V3)7-50 
SGOSIZE, (V3)7-50 
SHARE, (V3)7-51 
SID, (V3)7-51 
SIZE, (V3)7-51 
SMD, (V3)7-57 
//SOFTWARE, (V3)7-57 
SVC, (V3)7-58 
SWAPDEV, (V3)7-58 
SWAPLIM, (V3)7-59 
SWAPSIZE, (V3)7-59 
SWP, (V3)7-60 
SYCSIZE, (V3)7-60 
SYMTAB, (V3)7-60 
/SYSDEVS, (V3)7-60 
SYSMOD, (V3)7-61 
SYSONLY, (V3)7-61 
SYSTEM, (V3)7-61 
SYSTRAP, (V3)7-62 
/TABLES, (V3)7-62 
TERMPRI, (V3)7-62 
TIMER, (V3)7-62 
TITLE, (V3)7-63 
TQFULL, (V3)7-63 
TQMIN, (V3)7-63 
TRACE, (V3)7-64 
/TRAPS, (V3)7-64 
TSMEXIT, (V3)7-64 
USERPROG, (V3)7-65 
/VP, (V3)7-65 
VP, (V3)7-65 
VPID, (V3)7-65 

logical file code summary, (V3)7-3 
logical file codes, (V3)7-2 
object input file, (V3)3-l 
options, (V3)7-3 
nmning, (V3)3-3 
SYSINIT, (V3)2-23 
System 

build, (V3)l-1, (V3)3-l 
maintenance, (V3)l-1 
new default image, (V3)5-3 
recovery, (V3)6-l 
restart, (V3)5-l 
shutdown, (V3)10-45 
test, (V3)3-l, (V3)3-4 
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System Administrator, (Vl)4-13 
System Administrator Services 

abort codes and messages, (V3)10-18 
ACM/MFP initialization, (V3) 10-35 
ALIM initialization, (V3)10-26 
ANSI tape label utility (J.LABEL), 
(V3)10-62 

device initialization, (V3)10-19 
floppy disk initialization (J.FORMF), 
(V3)10-42 
INIT, (V3) 10-20 
introduction, (V3)10-l 
job accounting (M.ACCNT), (V3)10-15 
KEY program, see KEY 
LOGONFLE, (V3)10-20 
M.CNTRL, (V3)10-17 
M.ERR andxx.ERR files, (V3)10-18 
M.KEY, (V3)10-3 
M.PRJCT, (V3)10-ll 
memory disk partition, (V3)10-58 
multiprocessor recovery (J.UNLOCK), 
(V3) 10-53 

operator intervention inhibit, (V3)10-44 
password control, (V3)7-49 
PROJECT program, see PROJECT 
security, (V3) 10-22 
shadow memory, (V3)10-54 
swap scheduler control, (V3) 10-49 
system console messages, (V3)10-41 
system date/time backup (J.DTSAVE), 
(V3) 10-44 

system date/time update, (V2)2-20 
system shutdown, (V3)10-45 
terminal initialization, (V3)10-19 
volume mount (M.MOUNT), (V3)10-43 
SYSTEM as Ownemame, (V3)7-33, (V3)7-61 
System Binary Output, see SBO 
System Builder, (V3)2-23 
System Console, (V2)2-4 
configuration, (V3)2-l 
device definition, (V3)7-21 
device specification, (Vl)5-28 
messages, (V3)10-41 

System Console Type Service, (Vl)6-187, 
(Vl)7-189 

System Console Wait Service, (Vl)6-41, 

(VI >7-51 

System Control File, see SYC 
System Date and Time, update, (V2)2-20 
System Date/Time Backup Program 
(J.DTSAVE), (V3)10-44 
System Debugger (H.DBUG1, H.DBUG2) 
accessing, (V3)8-6 
arithmetic operators, (V3)8-2 
attach, (V2)2-12 
base characters, (V3)8-4 


bases, (V3)8-4 
breakpoints, (V3)8-3 
console address for stand-alone I/O, 
(V3)7-16 

directive list example, (V3)8-32 
directive summary, (V3)8-7 
directives 

AB (Absolute), (V3)8-9 
AD (Address), (V3)8-9 
AR (Arithmetic), (V3)8-10 
AS (Assemble Instruction), (V3)8-10 
BA (Base), (V3)8-10 
BR (Breakpoint), (V3)8-ll 
BY (Bye), (V3)8-ll 
CB (Change Base Register), (V3)8-12 
CD (Display Command List), (V3)8-12 
CE (Zero Command List), (V3)8-12 
CH (Display Controller Definition 
Table Entry), (V3)8-12 
CL (Terminate Build Directive List 
Mode), (V3)8-13 
CM (Change Memory), (V3)8-13 
CO (Continue), (V3)8-13 . 

CR (Change Register), (V3)8-14 
CS (Build Directive List), (V3)8-14 
CT (Continue then Terminate), 
(V3)8-14 

CX (Execute Directive List), (V3)8-14 
DB (Display Base Register), (V3)8-15 
DE (Delete), (V3)8-15 
DI (Display Instruction), (V3)8-15 
DM (Display Memory), (V3)8-15 
DQ (Display Dispatch Queue Entry), 
(V3)8-16 

DR (Display Register), (V3)8-16 
DS (Display Symbolic), (V3)8-16 
DT (Display Event Trace), (V3)8-17 
DU (Dump), (V3)8-17 
EC (Echo), (V3)8-17 
ET (Enter Event Trace Point), 

(V3)8-17 

GO (Go), (V3)8-18 
HC (Display Dispatch Queue Head 
Cell), (V3)8-18 

LB (List Breakpoint), (V3)8-19 
LP (Line Printer), (V3)8-19 
LT (List Mobile Event Trace Point), 
(V3)8-19 

MR (Map Register), (V3)8-19 
MS (Modify CPU Scratchpad 
Location), (V3)8-20 
PD (Display Patch List), (V3)8-20 
PE (Zero Patch List), (V3)8-20 
PR (Terminate Build Patch 
List Mode), (V3)8-21 
PS (Program Status), (V3)8-21 
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PT (Build Patch List), (V3)8-21 
PV (Convert Physical Address to 
Virtual Address), (V3)8-21 
PX (Execute Patch List), (V3)8-21 
RB (Reset Bases), (V3)8-22 
RE (Remap), (V3)8-22 
RT (Remove Event Trace Point), 
(V3)8-22 

SE (Search Equivalent), (V3)8-23 
SM (Set Mask), (V3)8-23 
SP (Scratchpad Dump), (V3)8-23 
SY (Symbolic), (V3)8-23 
TB (Trace Back), (V3)8-24 
TE (Terminate), (V3)8-24 
TR (Trace), (V3)8-24 
TS (Trace Stop), (V3)8-25 
TY (Terminal), (V3)8-25 
UD (Display Unit Definition Table 
Entry), (V3)8-25 
VP (Convert Virtual Address to 
Physical Address), (V3)8-26 
display a program, (V3)8-29 
display memory, (V3)8-27 
execution breakpoints, (V3)8-3 
expressions, (V3)8-5 
indirection, (V3)8-5 
introduction, (V3)8-l 
operator restrictions, (V3)8-5 
parts of, (V3)8-l 
patch list example, (V3)8-33 
practice session, (V3)8-26 
registers, (V3)8-5 
special functions, (V3)8-3 
special operators, (V3)8-2 
System Dispatch Queue, display, (V2)2-26 
System Distribution Tape, see SDT 
System General Output, see SGO 
System Generation, see SYSGEN 
System Halt Analysis, (V3)6-2 
System Image 

build a new default, (V3)5-3 
filename, (V3)7-61 
System Input Device, see SID 
System Listed Output, see SLO 
System Modules 
replace, (V3)7-61 
specify, (V3)7-65 

System Nonresident Media Mounting 
Task, (VQ1-13 

System Output Queues, display, (V2)2-26 
System Patch File, display, (V2)2-26 
System Protection, (V3)3-5 
System Recovery, (V3)6-l 
System Restart, (V3)5-l 


System Services 

base mode, (Vl)7-1 

IPU executable, (Vl)7-5 
syntax rules, (Vl)7-2 
cross reference, B-l 
H.VOMM macros, (Vl)5-65 
nonbase mode, (Vl)6-1 
IPU executable, (Vl)6-3 
overview, (Vl)l-10 
return conventions, (Vl)5-16 
status posting, (Vl)5-16 
System Shutdown 

error messages, (V3)10-48 
J.SHUTD, (V3)10-45 
overview, (V3)10-45 
SHUTDOWN, (V3)10-45, (V3)10-46 
volume clean-up, (V3)10-46 
System Start-up, Generation, and 
Installation, see SYSGEN 
System Task Restrictions, (V2)2-4 
System Volume, (Vl)4-15, (V3)5-5 

-T- 

Tab Settings, TSM, (V2)l-20 
Tabs, (V4)2-56 

Tape Drive, device definition, (V3)7-23 
Task 

abort dump, (V3)7-36 
abort, see Task, execution, abort 
base nonshared, (Vl)2-3 
base shared, (V 1)2-6 
change priority, (Vl)6-131, (Vl)7-131 
connect to interrupt level, (Vl)6-35, 
(Vl)7-41, (V2)2-10 
create timer, (Vl)6-159, (Vl)7-163 
delete timer, (Vl)6-56, (Vl)7-66, 
(V2)2-12 

demand page, (Vl)3-17 
disconnect from interrupt level, 

(V2)2-15 

display status, (V2)2-26, (V2)2-46 
environment, (Vl)6-66, (Vl)7-72 
execution, (V 1)2-7 

abort, (V 1 )2-46, (Vl)6-16, 

(Vl)6-50, (V 1)7-21, (V 1)7-59, 
(V2)l-19, (V2)2-6 
return control, (Vl)6-166, 

(V 1)7- 170 

attach debugger, (V2)l-19, (V2)2-12 
continue, (V2)l-19, (V2)l-20, 
(V2)l-49, (V2)2-l 1 
delete task, (V2)l-20 
from directive files, (V2)l-27, 
(V2)l-89 

from system service, (Vl)6-5, 
(Vl)7-7 
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hold, (V 1)6-87, (VI >7-90, 

(V2)l-19, (V2)2-23 
kill, (V2)2-25 

phase 1 of activation, (V 1)2-7 
phase 2 of activation, (V 1)2-8 
priorities, (Vl)2-10 
resume, (Vl)6-167, (Vl)6-185, 
(Vl)7-171, (Vl)7-187, (V2)2-10, 
(V2)2-40, (V2)2-44, (V2)2-58 
suspend, (Vl)6-41, (Vl)6-169, 
(V1)7-51,(V1)7-173 
suspend/resume, (V 1)6- 168, 

(Vl)7-172 

termination, (Vl)2-46, (Vl)2-47, 
(Vl)6-69, (Vl)7-75 
TSA, (Vl)2-8 

under OPCOM, (V2)2-7, (V2)2-21, 
(V2)2-44 

under TSM, (V2)l-16, (V2)l-34, 
(V2)l-45, (V2)l-59, (V2)l-88, 
(V2)l-102 
exit status, (Vl)7-78 
hold, (V2)2-23 

identification, (Vl)2-1, (Vl)6-88, 

(Vl)7-91 

interactive, characteristics, (V2)l-25 
interrupt, (V2)l-19 

context storage, (Vl)2-21 
level gating, (Vl)2-21 
levels, (V 1)2-20 
OPCOM, (V2)2-6, (V2)2-9, 

(V2)2-25 

receivers, (V 1)2-20 
scheduling, (Vl)2-20 
system services (Vl)2-20, (Vl)6-19, 
(Vl)6-55, (Vl)6-59, (Vl)6-64, 
(Vl)6-97, (Vl)6-170, (Vl)6-171, 
(Vl)6-198, (V 1)7-24, (Vl)7-63, 
(Vl)7-67, (Vl)7-70, (Vl)7-101, 
(Vl)7-174, (Vl)7-175, (Vl)7-200 
system services summary, (Vl)2-35 
user break receivers, (Vl)2-21 
limits of base mode, (Vl)7-103 
multicopied, (Vl)2-3 
name, (Vl)2-1 

nonbase mode vs. base mode, (Vl)2-2 
nonbase nonshared, (Vl)2-3, (Vl)2-5 
nonbase shared, (V 1)2-6 
number, (V 1)2-1 

obtain status, (Vl)6-118, (Vl)7-120 
option word inquiry, (Vl)6-126, 
(Vl)6-127, (Vl)7-124, (Vl)7-125 
override parameters, (Vl)6-133, (Vl)7-133 
priorities, (Vl)2-10 
priority levels, (VI) 1-7 
privileged, (Vl)6-132, (Vl)7-132 


shared, (Vl)2-3 
specify user name, (Vl)6-253 
state, (Vl)2-12, (Vl)2-13, (V2)l-20, 
(V2)2-28, (V2)2-52 
structure, (Vl)2-2 
swap scheduling, (V3)10-49 
termination, see Task, execution, 
termination 

test timer, (Vl)6-184, (Vl)7-186 
unique, (Vl)2-3 

unprivileged, (Vl)6-192, (Vl)7-192 
Task Cataloger, see CATALOG 
Task CPU Execution Time Service, 
(Vl)6-204, (Vl)7-206 
Task Debugger, (Vl)l-16 
Task Identification, (Vl)2-1 
Task Interrupt, see Task, interrupt 
Task Name, (Vl)2-1, (V2)2-4 
Task Number, (Vl)2-1, (V2)2-4 
Task Option Doubleword Inquiry Service, 
(Vl)6-126, (Vl)7-124 
Task Option Word Inquiry Service, 
(Vl)6-127, (Vl)7-125 
Task Service Area, see TSA 
Task Structure, (Vl)2-2 
Task-Synchronized Access to Common 
Resources, (Vl)2-49 
TCPB, (Vl)5-41, L-75 
TCW, (Vl)5-37 
TDEFLIST File, (V2)ll-5 
Temporary Files, see File, temporary 
TERMDEF 

access with M.GETDEF, (Vl)6-81, 
(V2)ll-18 

access with M_GETDEF, (Vl)7-81 
components 

J.TDEFI, (V2)ll-4 
J.TSET, (V2)ll-21 
LOGONFLE, (V2)ll-17 
M.GETDEF, (V2)ll-18 
TDEFLIST, (V2)ll-5 
TERMDEF file, (V2)ll-8 
TERMPART, (V2)ll-3 
demo, (V4)2-28, (V4)2-31 
exclude support, (V3)7-41 
file 

booleans, (V2)ll-9 
control strings, (V2)ll-9 
cursor addressing, (V2)ll-10 
sample, (V2)ll-12 
illustration, (V2)ll-2 
information block, (V2)ll-18 
utility, (V4)2-19 

Terminal Definition Facility, see TERMDEF 
Terminal I/O 

close, (V2)l-24 
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example session, (V2) 1-108 

exit, (V2)l-14, (V2)l-59 

input limitations, (V2)l-23 

open, (V2)l-24 

reads, (V2)l-23 

rewind scanner, (V2)l-24 

scan input buffer, (Vl)6-178, (Vl)7-180 

SYC, (V2)l-23 

type identification, (V2)ll-8, (V2)ll-17, 
(V2) 11-21 

wait state, (Vl)6-195, (Vl)7-197, 
(V2)l-105, (V2)2-60 
wakeup, (V2)l-8, (V2)l-20 
writes, (V2)l-24 

Terminal Initialization, (V3)3-5, (V3)10-19 
Terminal Initializer/Loader, (V4)2-56 
Terminal Services Manager, see TSM 
Terminal Timeout Counter, (V3) 10-23 
Terminal, user, see UT 
Terminate a Directive File, (V2)l-58 
Terminate Processing, (V2)l-49 
Terminate Task Execution Service, 

(VI >6-69, (Vl)7-75 
TER MP ART, (V2)ll-3 
Test Timer Entry Service, (Vl)6-184, 
(Vl)7-186 

Test User Status Word Service, (Vl)6-183, 
(Vl)7-185 

Testing a SYSGENed System, (V3)3-4 
Text Editor, (Vl)l-17 
Time and Date Formats, H-l 
Time Instruction Sequences, (V4)2-38 
Time Management, (Vl)l-12 
Time-of-Day Inquiry Service, (Vl)6-172, 
(Vl)7-176 
Time Quantum 

controls, (V 1)2- 11 
maximum, (V3)7-63 
minimum, (V3)7-63 
Time Units, (V3)7-39, (V3)7-42 
Timer Entry 

create, (VI >6-1 59, (VI >7-163 
delete, (Vl)6-56, (VI >7-66 
test, (Vl)6-184, (V 1)7- 186 
Timer Scheduler, (Vl)l-12 
Timer Table Entries, (V3)7-62 
Trap Handlers, (Vl)2-51, (V3)7-47 
override defaults, (V3)7-62 
Trap Online User’s Task Service, (Vl)6-171, 
(Vl)7-175 

Trap Processors, (Vl)l-12, (Vl)2-51, 
(V3)7-47 

Truncate File Service, (Vl)6-177, (Vl)7-179 
TSA 

description, (V 1 )2-8 
extended (Vl)3-34 


move, (Vl)3-28, (Vl)3-32, (V2)l-60 
pushdown stack area, (Vl)2-10 
starting address, (Vl)6-86, (Vl)7-89 
structure, (Vl)2-10 
TSM, (Vl)l-13, (V2)l-1 
break key, (V2)l-19 
break processor, (V2)l-27 
case sensitivity, (V2)l-20 
conditional processing, (V2)l-29 
device initialization, (V3)10-19 
directive syntax, (V2)l-33 
directives 

$$, (V2)l-106 

$$$, (V2)l-106 

SACCOUNT, (V2)l-33 

SACTIVATE, (V2)l-34 

$ ALLOCATE, (V2)l-35 

SASSIGN, (V2)l-36 

SASSIGN1, (V2)l-41 

$ASSIGN2, (V2)l-42 

$ASSIGN3, (V2)l-43 

SASSIGN4, (V2)l-44 

$BATCH, (V2)l-45 

SCALL, (V2)l -46 

SCHANGE, (V2)l-48 

$CLEAR, (V2)l-49 

SCONTINUE, (V2)l-49 

SCREATE, (V2)l-50 

$DEBUG, (V2)l-50 

SDEFM, (V2)l-51 

$DEFNAME, (V2)l-52 

SDELETE, (V2)l-53 

SDIRECTORY, (Vl)6-179, (Vl)7-181 

SDISABLE (V2)l-54 

SDISMOUNT, (V2)l-55 

SENABLE (V2)l-57 

SEND, (V2)l-58 

SENDM, (V2)l-58 

$EOJ, (V2)l-58 

$ERR, (V2)l-58 

SEXECUTE, (V2)l-59 

SEXIT, (V2)l-59 

SEXTDMPX, (Vl)3-33, (V2)l-60 

SGETPARM, (Vl)6-181 

SGOBACK, (V2)l-62 

SGOTO, (V2)l-63 

$IFA, (V2)l-64 

$IFF, (V2)l-66 

$IFP, (V2)l-64 

SIFT, (V2)l-69 

SINIT PRO, (V2)10-7 

SJOB, (V2)l-72 

SLINESIZE, (V2)l-75 

SLIST, (V2)l-76 

SMAPOUT, (V2)l-76 

SMOUNT, (V2)l-77 


r' 
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SNOMAPOUT, (V2)l-79 
$NOTE, (V2)l-80 
SOBJECT, (V2)l-80 
SOPTION, (V2)l-81 
SPAGESIZE, (V2)l-83 
SPRINT, (V2)l-84 
SPROJECT, (Vl)6-179, (Vl)7-181 
SRECALL, (V2)l-85 
SREMOVE, (V2)l-86 
SRENAME, (V2)l-87 
SRESETF, (V2)l-88 
SRESTART, (V3)5-2 
$RRS, (Vl)6-181 
$RUN, (V2)l-88 
$S ELECT, (V2)l-89 
SSELECTD, (V2)l-90 
SSELECTF, (V2)l-91 
SSELECTLD, (V2)l-92 
SSELECTLF, (V2)l-93 
SSELECTS, (V2)l-93 
$SET, (V2)l-94 
$SETF, (V2)l-95 
SSETI, (V2)l-96 
SSHADOW, (V2)l-98 
$SHOW, (V2)l-99 
SSIGNAL, (V2)l-101 
SSPACE, (V2)l-101 
SSUBMIT, (V2)l-102 
SSYSOUT, (V2)l-103 
STABS, (Vl)6-179, (Vl)7-181 
SURGENT, (V2)l-104 
SUSERNAME, (V2)l-104 
SVOLUME, (Vl)6-179, (Vl)7-I81 
SWAIT, (V2)l-105 
SWHO, (V2)l-106 
%label, (V2)l-52 
exit, (V2)l-59 

exit when inactive, (V3)7-42 
interactive tasks, (V2)l-25 
introduction, (V2)l-1 
JCL directive summary, (V2)l-2 
macro looping, (V2)l-29 
options, (V2)l-17, (V2)l-24, (V2)l-81 
abort, (V2)l-18, (V2)l-81 
clear, (V2)l-17, (V2)l-81 
command, (V2)l-17, (V2)l-81 
cpuonly, (V2)l-18, (V2)l-81 
dump, (V2)l-19, (V2)l-81 
error, (V2)l-18, (V2)l-81 
ipubias, (V2)l-19, (V2)l-81 
1/c, (V2)l-19, (V2)l-81 
lower, (VI >6-148, (Vl)6-163, 
(Vl)7-152, (Vl)7-167, (V2)l-17, 
(V2)l-81 

noabort, (V2)l-18, (V2)l-81 
nocommand, (V2)l-17, (V2)l-81 


noerror, (V2)l-18, (V2)l-81 
nowrap, (V2)l-18, (V2)l-81 
prompt, (V2)l-17, (V2)l-81 
quiet, (V2)l-18, (V2)l-81 
retain, (V2)l-17, (V2)l-81 
text, (V2)l-17, (V2)l-81 
u/c, (V2)l-19, (V2)l-81 
unquiet, (V2)l-18, (V2)l-81 
wrap, (V2)l-18, (V2)l-81 
parameter passing, (V2)l-29 
procedure call block, (Vl)6-180, (Vl)7-182, L-50 
procedure call directive strings, (Vl)6-179, 
(Vl)7-181 
scanner, (V2)l-25 
screen logic, (V2)l-21 
set options, (V2)l-81 
special keys, (V2)l-15 
tab settings, (V2)l-20 

TSM Procedure Call Block (PCB), (VI >6-1 80, 
(Vl)7-182, L-50 

TSM Procedure Call Service, (Vl)6-179, 

(Vl)7-181 

TSM Scanner Demo, (V4)2-59 
Type Control Parameter Block (TCPB), 

(VI >5-41, L-75 

-U- 

UDT, (V2)ll-4, (V2)ll-17, (V2)ll-21, L-77 

UDT Display, (V4)2-60 

Unformatted Media, (VI >5-25 

Unique Tasks, (Vl)2-3 

Unit Definition Table (UDT), (V2)ll-4, 

(V2)ll-17, (V2)ll-21, L-77 
Unlock and Dequeue Shared Memory 
Service, (VI >6-252 
Unsupported Software, (V4)2-l 
UPDATE, (Vl)l-19 
Upspace Service, (Vl)6-193, (Vl)7-195 
User Context 

overwrite, (Vl)7-138 
store values, (VI >7-80 
User Modules, (V3)7-37 
User Name, (VI >6-253 
User Name Specification Service, (VI >6-253 
User Status Word, (Vl)6-155, (Vl)6-183, 

(Vl)7-159, (Vl)7-185 
User Terminal, see UT 
User Volume, (Vl)4-15 
UT 

device definition, (V3)7-21 
exit, (V2)l-59 

I/O input limitations, (V2)l-23 
logical file code assignment, (V2)l-21 
wait state, (V2)l-105, (V2)2-60 
wakeup, (V2)l-8, (V2)l-20, (V3>10-20 
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Utilities 

AEDDB, (Vl)l-16 
ASMX32, (Vl)l-17 
CATALOG, see CATALOG 
DEBUGX32, (Vl)l-18 
DPEDIT, (Vl)l-17 
EDIT, (Vl)l-17 
illustration, (Vl)l-3 
J.VFMT, see J.VFMT 
KEY, see KEY 
LIBED, (Vl)l-17 
LINKX32, (Vl)l-18 
MACLIBR, (Vl)l-16 
MACX32, (Vl)l-17 
MEDIA, (Vl)l-19 
OBJX32, (VI >1-18 
SYSGEN, see SYSGEN 
UPDATE, (Vl)l-19 
VOLMGR, see VOLMGR 

-V- 

Validate Address Range Service, (Vl)6-194, 
(Vl)7-196 

Vector Processor Configuration, 

(V3)7-65, (V3)7-66 

VOLMGR, (Vl)l-17, (V2)3-l 
access, (V2)3-14 
BRIEF option, (V2)3-8 
clear options, (V2)3-23 
directive summary, (V2)3-7 
directive syntax, (V2)3-18 
directives 

BACKSPACE FILE, (V2)3-22 
BACKSPACE IMAGE, (V2)3-22 
CLEAR, (V2)3-23 
CONVERT, (V2)3-23 
COPY, (V2)3-25 
CREATE COMMON, (V2)3-29 
CREATE DIRECTORY, (V2)3-32 
CREATE FILE, (V2)3-34 
DELETE COMMON, (V2)3-37 
DELETE DIRECTORY, (V2)3-38 
DELETE FILE, (V2)3-39 
EXIT, (V2)3-40 
EXTEND, (V2)3-41 
HELP, (V2)3-41 
LOG FILE, (V2)3-42 
LOG IMAGE, (V2)3-43 
LOG RESOURCE, (V2)3-44 
LOG SAVEFILE, (V2)3-46 
RENAME, (V2)3~47 
RESTORE DIRECTORY, (V2)3-48 
RESTORE POSITION, (V2)3-53 
REWIND, (V2)3-53 
SAVE, (V2)3-54 

SAVE INCREMENTAL, (V2)3-57 


SDT, (V2)3-58 
SDT MASTER, (V2)3-60 
SET, (V2)3-61 
SKIP END, (V2)3-64 
SKIP FILE, (V2)3-64 
SKIP IMAGE, (V2)3-65 
TRUNCATE, (V2)3-65 
errors, (V2)3-66 

global options, (V2)3-18, (V2)3-19 
help, (V2)3-41 
introduction, (V2)3-l 
local options, (V2)3-18, (V2)3-19 
logical file code assignments, (V2)3-16 
options, (V2)3-17 
BRIEF, (V2)3-8 
clear, (V2)3-23 
global, (V2)3-18, (V2)3-19 
local, (V2)3-18, (V2)3-19 
set, (V2)3-61 
time, (V2)3-20 

resource descriptor tape record, (V2)3-6 
save image, (V2)3-3 
save tape format, (V2)3-l 
save tape structure, (V2)3-2 
set options, (V2)3-61 
temporary files, (V2)3-17 
time options, (V2)3-20 
wild card characters, (V2)3-15, (V2)3-17 
Volume, (Vl)4-14 

access attributes, (Vl)3-8, (Vl)4-16 
automatic public mount, (V3)9-l 1 
boot block, (Vl)4-22 
descriptor, (V 1)4-22 

dismount, (Vl)4-14, (Vl)4-18, (Vl)6-57, 
(Vl)7-64, (V2)l-55, (V2)2-16 
explicit, (Vl)4-19 
implicit, (VI >4-19 
logical, (VI >4-18 
physical, (Vl)4-19 
formatted, (V 1)4- 14 
mount, (Vl)4-14, (Vl)4-17, (Vl)6-115, 
(Vl)7-116, (V2)l-77, (V2)2-33 
explicit, (Vl)4-18 
implicit, (Vl)4-18 
logical, (Vl)4-18 
physical, (VI >4-17 
multiprocessor, (Vl)4-16, (Vl)4-47, 
(Vl)4-49 

nonpublic, (Vl)4-16 
public, (Vl)4-16, (V 1)4-20 
inhibit dismount, (V3)7-13 
rename, (V4)2-44 
resource access, (Vl)5-20 
space management, (Vl)5-20 
status, display, (V2)2-46 
structure, (Vl)4-20, (Vl)4-21 
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system, (Vl)4-15, (V 1)4-20 
types, (Vl)4-15 
user, (Vl)4-15 
user default, (V3)10-4 
Volume Compress, see J.DSCMP 
Volume Formatter, see J.VFMT 
Volume Management Module, see H.VOMM 
Volume Manager, see VOLMGR 
Volume Resource Management, (Vl)4-1 
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Wait for Any Break Interrupt Service, 
(Vl)6-7, (Vl)7-ll 

Wait for Any Message Interrupt Service, 

(V 1)6-7, (Vl)7-ll 

Wait for Any No-Wait Operation Complete 
Service, (Vl)6-7, (Vl)7-ll 
Wait I/O, (Vl)5-32 

Wait I/O Service, (Vl)6-195, (Vl)7-197 
Wait States, (Vl)2-25, (Vl)2-26, (Vl)6-63, 
(Vl)6-195, (Vl)7-ll, (Vl)7-15, 
(Vl)7-197, (V2)l-105, (V2)2-60, 
(V3)10-50, (V3) 10-51 
Wakeup, (V2)l-8, (V2)l-20, (V3)10-20 
Word Locations, dump, (V2)2-18, (V2)2-45 
Write EOF Service, (Vl)6-196, (Vl)7-199 
Write Record Service, (Vl)6-197, (Vl)7-198 
xc.ERR Files, (V3)10-18 
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